> ## Documentation Index
> Fetch the complete documentation index at: https://docs.gamerhash.com/llms.txt
> Use this file to discover all available pages before exploring further.

# GamerHash AI App 설치

> 다운로드부터 첫 채팅까지 5분 단계별 가이드.

export const Win = () => <span style={{
  display: 'inline-block',
  padding: '2px 10px',
  borderRadius: '999px',
  fontSize: '0.82em',
  fontWeight: 600,
  background: 'rgba(0,120,212,0.18)',
  color: '#7CC4FF',
  border: '1px solid #0078D4',
  whiteSpace: 'nowrap'
}}>Windows</span>;

AI App 다운로드부터 첫 채팅까지의 흐름을 정리한 가이드입니다. 소요 시간은 **약 5분**이며, 모델 다운로드는 백그라운드에서 별도로 진행됩니다(모델 크기에 따라 다름).

## 시작 전 체크

<CardGroup cols={2}>
  <Card title="하드웨어 확인" icon="microchip">
    <Win /> 10/11, VRAM **8 GB 이상**의 NVIDIA RTX, 최신 드라이버. 자세한 사양은 [하드웨어 요구사항](/ko/ai/hardware-requirements) 참고.
  </Card>

  <Card title="디스크 공간" icon="hard-drive">
    모델 다운로드용으로 약 30 GB 여유. 여러 모델을 캐시할 거라면 더 많이 확보하세요.
  </Card>

  <Card title="GamerHash 계정" icon="user">
    설치 중에 생성합니다. 이메일 또는 Google 로그인 둘 다 가능.
  </Card>

  <Card title="네트워크" icon="wifi">
    광대역 회선. 초기 모델 다운로드 용량이 큽니다(모델별 4\~20 GB).
  </Card>
</CardGroup>

## 1. 다운로드

<Steps>
  <Step title="다운로드 페이지 열기">
    [gamerhash.com/en/app-download](https://gamerhash.com/en/app-download)에 접속해 **Download GamerHash AI**를 클릭합니다. 설치 파일은 서명된 `.exe`입니다.
  </Step>

  <Step title="설치 파일 실행">
    다운로드한 `.exe`를 더블 클릭합니다. Windows가 관리자 권한을 요청하면 허용하세요. 설치 파일은 GamerHash가 서명한 것입니다. Windows SmartScreen 경고가 뜨면 **추가 정보 → 실행**을 누르면 됩니다.
  </Step>

  <Step title="설치 경로 선택">
    대부분 기본 경로로 충분합니다. 드라이브가 여러 개라면 여유 공간이 가장 많은 드라이브로 지정하세요. 모델 파일이 이 경로에 쌓입니다.
  </Step>
</Steps>

## 2. 첫 실행

<Steps>
  <Step title="로그인 또는 계정 생성">
    첫 실행 시 안내가 뜹니다. **Google 로그인**이 가장 빠르고, 이메일 + 비밀번호 가입도 가능합니다.
  </Step>

  <Step title="GPU 벤치마크">
    앱이 워크로드 크기를 보정하기 위해 GPU를 한 번 벤치마크합니다. 약 1분 정도 걸리고, 하드웨어를 바꾸지 않는 한 다시 돌릴 필요는 없습니다.
  </Step>

  <Step title="첫 모델 선택">
    Model Center가 열립니다. 첫 채팅용으로 본인 GPU에 적합하다고 표시된 모델을 고르세요(각 모델에 VRAM 호환 배지가 붙어 있습니다). **Download**를 클릭하면 진행률이 표시됩니다.
  </Step>
</Steps>

<Note>
  첫 모델 다운로드가 전체 과정에서 가장 오래 걸립니다. 작은 텍스트 모델(약 5 GB)은 일반 가정 회선 기준 5~~15분이면 받습니다. 이미지·비디오 모델은 10~~20 GB까지 갑니다.
</Note>

## 3. 첫 채팅 보내기

<Steps>
  <Step title="Chat 모듈 열기">
    대시보드에서 **Chat**을 클릭합니다. 방금 받은 모델이 자동으로 선택되어 있을 겁니다.
  </Step>

  <Step title="프롬프트 입력">
    질문을 입력하고 Enter. 첫 응답에는 모델 워밍업이 포함되며, 이후 응답은 훨씬 빠릅니다.
  </Step>

  <Step title="응답 확인">
    응답은 토큰 단위로 스트리밍됩니다. 생성은 전적으로 본인 GPU에서 일어나며, 외부 클라우드로 아무것도 전송되지 않습니다.
  </Step>
</Steps>

## 4. 이미지 생성도 한 번 돌려보기

<Steps>
  <Step title="Image 모듈로 전환">
    대시보드 사이드바에서 **Image Generation**을 선택합니다.
  </Step>

  <Step title="모델 선택">
    8 GB GPU라면 **Sana Sprint**가 첫 선택지로 무난합니다. 빠르고 품질도 좋습니다. 12 GB 이상이라면 **FLUX.1 Schnell**을 추천합니다.
  </Step>

  <Step title="이미지 생성">
    프롬프트를 입력하고 **Generate**를 클릭하면 결과가 갤러리에 표시됩니다. 우클릭으로 저장하거나 복사할 수 있고, 이미지는 로컬에만 저장됩니다.
  </Step>
</Steps>

## 5. Earn 모듈로 수익 내기 (선택)

유휴 GPU 파워를 공유해 GUSD를 받고 싶다면 다음 절차를 따르세요.

<Steps>
  <Step title="Earn 모듈 열기">
    사이드바 → **Earning**. 안내를 확인한 뒤 모듈을 켭니다.
  </Step>

  <Step title="게임 안 할 때 켜두기">
    Earn 워크로드는 GPU와 VRAM을 전부 사용하므로, 게임과 동시에 돌릴 수는 없습니다. 게임을 실행하면 모듈이 자동으로 빠지고, 게임을 종료하면 알아서 다시 들어옵니다.
  </Step>

  <Step title="GUSD 적립 확인">
    큐 상황에 따라 작업이 GPU로 들어오기 시작합니다. 대시보드에서 시간당 실시간 수익을 바로 볼 수 있습니다.
  </Step>
</Steps>

## 트러블슈팅

<AccordionGroup>
  <Accordion title="설치 파일이 실행되지 않거나 Windows SmartScreen 경고가 뜸">
    **추가 정보** → **실행**을 클릭하면 됩니다. 설치 파일은 GamerHash sp. z o.o. 명의로 서명되어 있으니, 인증서 대화상자에서 게시자가 맞는지 확인하세요.
  </Accordion>

  <Accordion title="벤치마크 실패">
    대부분 드라이버 문제입니다. 최신 **NVIDIA Studio** 드라이버로 업데이트하고 재부팅 후 다시 시도하세요. 그래도 실패하면 **Game Ready** 드라이버를 시도해 보세요. 그래도 안 되면 GPU 모델명과 함께 Discord `#support`에 제보해 주세요.
  </Accordion>

  <Accordion title="모델 다운로드가 멈춤">
    Model Center에서 일시 정지 후 다시 시작해 보세요. 계속 멈춘다면 디스크 여유 공간을 확인하고, 공격적으로 작동하는 백신은 잠시 비활성화하세요. 일부 백신은 GB 단위 파일을 매우 느리게 스캔합니다.
  </Accordion>

  <Accordion title="채팅 응답이 느리거나 첫 응답이 너무 늦음">
    첫 응답은 모델을 VRAM에 올리는 콜드 스타트가 포함됩니다. 이후 응답은 빨라집니다. 그런데도 계속 느리다면 VRAM 한계에 부딪힌 가능성이 있으니, 같은 모델의 더 작은 양자화 버전으로 바꿔보세요.
  </Accordion>

  <Accordion title="Earn 모듈에 작업이 들어오지 않음">
    가동 시간이 짧거나, GPU 등급이 받을 수 있는 풀이 좁거나, 현재 네트워크 수요가 낮은 경우입니다. 인앱 대시보드와 Medium 커뮤니티 업데이트에서 현재 네트워크 수요를 확인해 보세요.
  </Accordion>
</AccordionGroup>

## 다음 단계

<CardGroup cols={2}>
  <Card title="GPU 공유로 수익 내기" icon="coins" href="/ko/tutorials/earn-with-gpu">
    Earn 모듈을 더 자세히 다룹니다.
  </Card>

  <Card title="모듈" icon="layer-group" href="/ko/ai/modules">
    앱이 제공하는 전체 모듈 살펴보기.
  </Card>
</CardGroup>