시스템 요구 사항

플랫폼 실행 전 다음 조건을 충족시켜야 합니다:

• 운영체제: macOS/Windows/Linux
• 파이썬 버전: 3.9 이상
• 하드웨어: 성능 최적화를 위해 별도 그래픽 카드 권장

macOS 설치 절차

자동 설치

brew install katrain

명령어로 자동으로 엔진과 의존성 패키지를 설치합니다.

수동 설치

1. Homebrew 설치:
   

   /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/master/install.sh)"

2. 필요 패키지 설치:
   

   brew install python3<br>brew install katago

3. 플랫폼 설치:
   

   pip3 install katrain

윈도우 배포

빌드 도구 사용

프리컴파일된 설치 파일을 다운로드하여 간단한 클릭으로 완료 가능

소스코드 빌드

1. 소스 패키지 압축 해제
2. Anaconda 환경 설정
3. 터미널에서:
   

   pip3 install .

리눅스 구현

빠른 배포

pip3 install -U katrain

터미널에서 `katrain` 명령어로 실행 가능

수동 컴파일

1. 레포지토리 클론:
   

   git clone https://gitcode.com/gh_mirrors/ka/katrain<br>cd katrain

2. 필요 라이브러리 설치:
   

   sudo apt-get install python3-pip build-essential git python3 python3-dev ffmpeg libsdl2-dev ...

3. 의존성 처리:
   

   pip3 install poetry<br>poetry install

핵심 기능

분석 모듈

실시간 평가 지표 시각화 및 색상 코드 기반 전략 비교 기능 제공

AI 대전 모드

• 교육용: 잘못된 수를 자동 회수하는 기능
• 즉시 피드백: 각 수에 대한 오류 확률 표시
• 다양한 AI 스타일 선택 지원

그래픽 가속 최적화

다중 GPU 시스템에서 하드웨어 리소스 활용을 위한 설정:

1. 구성 파일 수정:
   

   katrain/KataGo/analysis_config.cfg

2. 스레드 수 설정:
   

   gpuThreadCountPerModel = 2

3. 디바이스 ID 지정:
   

   openclDeviceIdForThread0 = 1<br>openclDeviceIdForThread1 = 2

문제 해결 가이드

엔진 시작 오류

• OpenCL 드라이버 상태 확인
• PATH 변수에 경로 추가
• CPU 버전 라이브러리 사용 시도

입력 키보드 단축키

• Tab: 분석/게임 모드 전환
• Q: 서브노드 수 표시 제어
• E: 다음 예측 수 표시
• Home/End: 게임 로그 시작/종료 이동

테마 커스터마이징

전통적 체스판 스타일부터 현대적 UI 디자인까지 다양한 테마 제공