kis-setup

name	kis-setup
description	KIS 환경을 진단하거나 설치할 때 반드시 사용. '환경 확인', '설치해줘', 'setup', 'kis-setup'이라고 할 때 자동 실행된다.

KIS Setup

스크립트 경로

• 환경 진단: uv run <프로젝트루트>/.codex/scripts/setup_check.py <프로젝트루트>

인자 처리

입력	동작
(인자 없음)	전체 진단 + 실패 항목 순서대로 수정
check, status, 상태	진단만 수행, 수정 없음
p1	P1만 설치 (uv sync + pnpm install)
p2	P2만 설치 (uv sync + pnpm install + lean)
lean	Lean 환경만 설정
mcp	MCP 서버 시작만

실행 순서

Step 1: 환경 진단

setup_check.py <프로젝트루트> 실행 후 상태 표로 출력. all_ok가 true면 "모든 설정이 완료되었습니다!"라고 안내 후 종료.

Step 2: 사전 요구사항 (prereqs 실패 시)

항목	안내
Python	brew install python@3.11 또는 공식 사이트
uv	curl -LsSf https://astral.sh/uv/install.sh | sh
Node.js	brew install node 또는 nvm
Docker 미설치	docker.com/products/docker-desktop
Docker 미실행	"Docker Desktop을 시작해주세요" 안내 후 대기

Step 3: KIS 설정파일 (kis_config 실패 시)

~/KIS/config/kis_devlp.yaml 없으면 아래 템플릿 안내:

my_app: "실전투자 앱키"
my_sec: "실전투자 앱시크릿"
paper_app: "모의투자 앱키"
paper_sec: "모의투자 앱시크릿"
my_htsid: "HTS ID"
my_acct_stock: "증권계좌 8자리"
my_paper_stock: "모의투자 증권계좌 8자리"
my_prod: "01"

절대로 config 파일을 직접 읽거나 쓰지 않는다.

Step 4~6: 의존성 및 Lean 환경

• P1: cd strategy_builder && uv sync + cd frontend && pnpm install + .env.local 없으면 생성: cp strategy_builder/frontend/.env.example strategy_builder/frontend/.env.local

  ⚠️ 호가창 WebSocket(실시간 호가)을 사용하려면 .env.local의 NEXT_PUBLIC_API_URL=http://localhost:8000 설정이 필수입니다.

• P2: cd backtester && uv sync + cd frontend && pnpm install
• Lean: bash backtester/scripts/setup_lean_data.sh

Step 7: MCP 서버

bash backtester/scripts/start_mcp.sh 백그라운드 실행 후 http://127.0.0.1:3846/health 확인.

Step 8: 인증

"모의투자로 시작하려면 '인증해줘 vps'를 입력하세요."

주의사항

• kis_devlp.yaml을 직접 읽거나 쓰지 않는다.
• 각 단계는 멱등(idempotent) — 이미 완료된 단계는 건너뛴다.