-
Notifications
You must be signed in to change notification settings - Fork 0
Getting Started
umyunsang edited this page Apr 6, 2026
·
2 revisions
GovOn 프로젝트를 로컬에서 실행하기 위한 가이드입니다.
- Python 3.10+
- (권장) uv 패키지 매니저
- (GPU 추론) CUDA 12.x, NVIDIA 드라이버
git clone https://github.com/umyunsang/GovOn.git
cd GovOn
uv sync --extra dev --extra inference --extra databasepython -m venv venv && source venv/bin/activate pip install -r requirements.txt
cp .env.example .env # 환경변수 설정
docker compose up -d --buildcp .env.example .env
핵심 변수:
| 변수 | 설명 | 기본값 |
|---|---|---|
MODEL_PATH |
모델 경로 | - |
SKIP_MODEL_LOAD |
GPU 없이 개발 시 true
|
false |
DATA_GO_KR_API_KEY |
공공데이터포털 API 키 | - |
LOG_LEVEL |
로그 레벨 | INFO |
# 테스트 실행 pytest tests/test_inference -q # API 서버 시작 python -m uvicorn src.inference.api_server:app --host 127.0.0.1 --port 8000 # 헬스 체크 curl http://127.0.0.1:8000/health
govon # 대화형 셸 시작 govon --session <id> # 세션 재개
- Development Guide — 브랜치/커밋/PR 규칙
- Troubleshooting — 문제 해결
GovOn Wiki
외부 링크