Getting Started

GovOn 프로젝트를 로컬에서 실행하기 위한 가이드입니다.

사전 요구사항

• Python 3.10+
• (권장) uv 패키지 매니저
• (GPU 추론) CUDA 12.x, NVIDIA 드라이버

설치 방법

방법 1: uv (권장, CI 동일 환경)

git clone https://github.com/umyunsang/GovOn.git
cd GovOn
uv sync --extra dev --extra inference --extra database

방법 2: pip

python -m venv venv && source venv/bin/activate
pip install -r requirements.txt

방법 3: Docker

cp .env.example .env   # 환경변수 설정
docker compose up -d --build

환경 변수 설정

cp .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

CLI 실행

govon                        # 대화형 셸 시작
govon --session <id>         # 세션 재개

다음 단계

• Development Guide — 브랜치/커밋/PR 규칙
• Troubleshooting — 문제 해결