명령줄 · 07

Read19 CLI: 클라우드 KataGo를 GUI와 스크립트에 연결

네이티브 CLI에서 한 번 로그인한 뒤 GTP나 Analysis Engine JSONL을 고릅니다. Sabaki, LizzieYzy, q5Go, KaTrain 모두 로컬에서 모델이나 GPU를 관리하지 않습니다.

  1. 네이티브 CLI를 설치하고 로그인합니다

    /cli에서 운영체제와 칩에 맞는 네이티브 빌드를 받아 SHA-256을 확인하고 압축을 풉니다. read19는 macOS라면 ~/.local/bin/read19, Windows라면 C:\Tools\read19.exe처럼 고정된 위치에 둡니다. macOS 빌드는 아직 공증되지 않았으므로 브라우저로 받았다면 먼저 xattr -d com.apple.quarantine read19를 실행합니다. 이어 read19 login(브라우저가 없으면 --no-open)과 read19 engine setup --name "MacBook · Sabaki"로 이 클라이언트 전용 키를 만들어 저장합니다.

    login은 계정 승인, engine setup은 이 클라이언트만 따로 취소할 수 있는 자격 증명 생성입니다.
  2. GUI에서는 engine gtp를 선택합니다

    바탕화면에서 실행한 GUI는 터미널의 PATH를 읽지 않으므로 반드시 절대 경로를 씁니다. Sabaki: 엔진 → 엔진 관리 → 추가에서 경로에 read19 절대 경로, 인수에 engine gtp를 넣고 엔진 사이드바에서 불러온 뒤 F4로 분석을 켜고 끕니다. LizzieYzy: 인공지능 엔진 설정에서 명령어에 “/절대경로/read19 engine gtp”를 한 줄로 넣습니다. CLI 0.2.14 이상이 필요합니다. q5Go도 같은 경로와 engine gtp를 씁니다. KaTrain은 GTP를 쓰지 않으므로 로컬 엔진의 “엔진 명령어 덮어씌우기”에 “/절대경로/read19 engine analysis”를 넣거나 계정 페이지의 WebSocket URL을 사용합니다.

    GUI에는 로컬 GTP 프로세스로 보이고 CLI가 국면을 클라우드 요청으로 바꿔 GTP 응답을 돌려줍니다.
  3. 스크립트에서는 engine analysis를 선택합니다

    완전한 JSON이 필요하면 read19 engine analysis를 실행하고 stdin에 한 줄씩 Analysis Engine query를 쓰며 stdout에서 결과를 줄마다 읽습니다. stdin을 닫으면 CLI는 이미 보낸 query의 최종 결과를 기다린 뒤 종료합니다. read19 usage, statement, status로 사용량, 내역과 서비스 상태를 확인할 수 있습니다. GUI의 연속 분석은 멈출 때까지 탐색하므로 판을 보지 않을 때는 분석을 꺼 두세요.

    JSONL 경로는 GUI를 거치지 않아 셸 파이프, Python, Node.js와 일괄 연구 도구에 맞습니다.

전체 명령

  1. Read19 CLI 다운로드와 명령
  2. KataGo GTP 확장

성공 신호

  • read19 account가 계정을 읽는다
  • GUI의 엔진 이름이 KataGo Read19로 보인다
  • 후보 수가 갱신되고 멈춘 뒤에는 늘지 않는다
  • 사용량에 해당 작업이 나타난다
모델과 지표 읽기