.env.example

# ═══════════════════════════════════════════════════════════════
#  PROJECT JAMES — Environment Variables (Example)
#  
#  이 파일을 .env로 복사한 후 실제 값으로 채워주세요.
#  
#  Copy this file to .env and fill in real values.
#  NEVER commit .env to git.
# ═══════════════════════════════════════════════════════════════

# ── API 인증 키 (필수) ──────────────────────────────────────────
# 외부 클라이언트 식별용. 임의 문자열 가능.
JAMES_API_KEY=your-api-key-here

# ── JWT 시크릿 (필수, 절대 외부 노출 금지) ─────────────────────
# 생성: python -c "import secrets; print(secrets.token_urlsafe(32))"
# 운영 환경에서는 반드시 32자 이상 랜덤 문자열 사용
JAMES_JWT_SECRET=your-jwt-secret-here-min-32-chars

# ── Tavily 웹 검색 (선택) ──────────────────────────────────────
# 무료 키 발급: https://tavily.com (1,000 req/month)
# 미설정 시 DuckDuckGo로 자동 fallback
TAVILY_API_KEY=tvly-your-tavily-key-here

# ── 보호 파일 목록 (선택) ──────────────────────────────────────
# Tool 접근/수정 차단할 파일들 (쉼표 구분)
JAMES_PROTECTED_FILES=core/security_layer.py,core/auth.py,config.py

# ── LLM 프롬프트 길이 캡 (선택, 단 리포트/장문 생성엔 사실상 필수) ──
# Gemma 클라이언트는 모든 프롬프트를 이 글자 수로 잘라냅니다. 코드
# 기본값은 4000자(측정 재현성 byte-identical 유지용)지만, 리포트 작성
# 시 컨텍스트+지시문이 함께 4000자로 잘려 보고서가 짧게/불완전하게
# 나옵니다(synth 프롬프트 7760 → 4000 절단 사례). 운영 환경에서는 synth
# 컨텍스트 예산(JAMES_SYNTH_CONTEXT_CHARS, 기본 8000) + 페르소나/메모리/
# 지시문 여유를 덮도록 16000 이상 권장. (gemma3:12b 등 컨텍스트 윈도우
# 충분.)
JAMES_GEMMA_MAX_PROMPT_CHARS=16000

# synth 단계 검색 컨텍스트 글자 수 상한 (기본 8000). 위 프롬프트 캡보다
# 작아야 의미 있음.
# JAMES_SYNTH_CONTEXT_CHARS=8000

# ── Tesseract OCR 경로 (Windows만 해당) ───────────────────────
# 기본 경로와 다르면 명시
# TESSERACT_PATH=C:\Program Files\Tesseract-OCR\tesseract.exe

# ── Poppler 경로 (Windows만 해당, PDF 처리용) ─────────────────
# POPPLER_PATH=C:\Program Files\poppler\Library\bin