빠른 시작
0. 도구 체인(mise)
Python, Node.js, pnpm, uv 버전은 mise.toml에 고정되어 있고 mise가 이를 설치하므로, 어느 컴퓨터에서나 같은 도구 체인이 실행됩니다. mise는 한 번만 설치하면 됩니다.
| OS | 명령 |
|---|---|
| Windows | winget install jdx.mise |
| macOS | brew install mise |
| Linux | 설치 문서를 참조하세요 |
셸에서 mise를 활성화한 다음(bash/zsh/fish는 활성화 문서를 참조하세요. Windows에서는 PowerShell의 $PROFILE에 (&mise activate pwsh) | Out-String | Invoke-Expression을 추가합니다) 저장소 루트에서 도구를 설치합니다.
mise trust
mise install
Windows에서는 mise의 shims 디렉터리(%LOCALAPPDATA%\mise\shims)도 PATH에 추가하세요. 그래야 활성화된 셸 밖에서도 uv, pnpm, python을 찾을 수 있습니다.
mise를 사용하지 않는다면 최소 버전은 Python 3.11 이상, Node.js 20 이상이며, uv와 pnpm은 직접 설치해야 합니다.
1. 백엔드
백엔드 자체에는 Python과 uv만 있으면 됩니다. Node.js는 npm 패키지로 배포된 stdio MCP 서버를 npx로 실행할 때만 사용하며, docker compose 이미지에는 포함되어 있습니다.
cd backend
uv sync
cp .env.example .env
sed -i.bak 's/^SYSTEM_DEFAULT_LLM_API_KEY=.*/SYSTEM_DEFAULT_LLM_API_KEY=YOUR_API_KEY/' .env && rm .env.bak
uv run uvicorn main:app --host 0.0.0.0 --port 8000 --timeout-graceful-shutdown 30
.env.example의 기본값은 Google Gemini이므로 YOUR_API_KEY를 본인의 키로 바꾸세요. 다른 모델이나 제공자를 사용하려면 LLM 설정을 참조하세요.
이제 http://localhost:8000에서 API를 사용할 수 있습니다.
2. 프런트엔드
cd frontend
pnpm install
# 선택 사항: cp .env.local.example .env.local (백엔드가 :8000에 있지 않을 때만 필요)
pnpm build
pnpm start
http://localhost:3000을 엽니다. 다른 포트에서 실행하려면 프런트엔드 README의 Changing the port를 참조하세요.