env.example

# ===========================================
# FreshQA Leaderboard 환경변수 설정 예시
# ===========================================

# ===========================================
# Hugging Face 설정
# ===========================================
# Hugging Face API 토큰 (필수)
# - Private repository 접근용
# - https://huggingface.co/settings/tokens 에서 발급
HF_TOKEN=your_huggingface_token_here

# ===========================================
# FreshQA 기준 데이터 설정
# ===========================================
# 기준 데이터가 있는 HuggingFace Repository ID (필수)
# 형식: username/repository-name
FRESHQA_DATA_REPO_ID=james-demo-leaderboard-backend/kofreshqa-data-origin

# 기준 데이터 파일명 (선택사항, 기본값: ko-freshqa_2025_total.csv)
FRESHQA_DATA_FILENAME=ko-freshqa_2025_total.csv

# ===========================================
# FreshQA 프롬프트 설정
# ===========================================
# Fresheval 프롬프트 본문
# 평가 프롬프트는 제공하지 않습니다.
FRESHQA_PROMPT_RELAXED=
FRESHQA_PROMPT_STRICT=

# ===========================================
# 제출 추적 설정
# ===========================================
# 제출 기록을 저장할 HuggingFace Repository ID (필수)
# 형식: username/repository-name
SUBMISSION_TRACKER_REPO_ID=james-demo-leaderboard-backend/submission-tracker

# 제출 제한 기능 활성화 여부 (선택사항, 기본값: true)
# - true: 제출 제한 기능 활성화 (하루 3회 제한)
# - false: 제출 제한 기능 비활성화 (로컬 테스트용)
ENABLE_SUBMISSION_LIMIT=true

# ===========================================
# 리더보드 저장 설정
# ===========================================

# 리더보드를 HuggingFace private dataset에도 저장할지 여부
# - true : 로컬 CSV 저장 + HF dataset에도 업로드 (권장: 운영/배포 환경)
# - false: 로컬 CSV에만 저장 (권장: 로컬 개발 환경)
UPLOAD_LEADERBOARD_TO_HF=false

# (참고) 리더보드는 기준 데이터와 동일한 Repository(FRESHQA_DATA_REPO_ID)에 leaderboard_results.csv 파일명으로 저장됩니다.

# ===========================================
# AI 평가 API 설정
# ===========================================
# Upstage Solar Pro API 키 (필수)
# - 모델 평가용
# - https://console.upstage.ai/ 에서 발급
UPSTAGE_API_KEY=your_upstage_api_key_here

# 여러 개의 Upstage API 키를 사용할 경우(선택사항)
# - 콤마로 구분하여 입력
# - 설정 로더는 UPSTAGE_API_KEYS가 존재하면 이를 우선 사용하고,
#   없으면 단일 변수 UPSTAGE_API_KEY를 사용합니다.
# 예시)
# UPSTAGE_API_KEYS=keyA,keyB,keyC

# ===========================================
# 애플리케이션 설정
# ===========================================
# 서버 포트 (선택사항, 기본값: 7860)
# PORT=7860

# 디버그 모드 (선택사항, 기본값: false)
# DEBUG=false

# ===========================================
# 사용 예시
# ===========================================
# 1. 이 파일을 .env로 복사하세요:
#    cp env.example .env
#
# 2. 실제 값으로 변경하세요:
#    - HF_TOKEN: 실제 HuggingFace 토큰
#    - FRESHQA_DATA_REPO_ID: 실제 repository ID
#    - FRESHQA_DATA_FILENAME: 실제 파일명 (선택사항)
#    - SUBMISSION_TRACKER_REPO_ID: 제출 추적용 repository ID
#    - ENABLE_SUBMISSION_LIMIT: 제출 제한 기능 활성화 여부 (로컬 테스트 시 false)
#    - UPSTAGE_API_KEY: 실제 Upstage API 키
#
# 3. Python에서 자동 로드됨 (app.py에서 load_dotenv() 호출)
#    또는 수동으로 로드:
#    from dotenv import load_dotenv
#    load_dotenv()
#
# 4. 또는 직접 환경변수 설정 (시스템 레벨):
#    export HF_TOKEN="your_token"
#    export FRESHQA_DATA_REPO_ID="username/repo"
#    export FRESHQA_DATA_FILENAME="filename.csv"
#    export UPSTAGE_API_KEY="your_api_key"

# ===========================================
# 보안 주의사항
# ===========================================
# - .env 파일은 절대 Git에 커밋하지 마세요
# - 실제 토큰과 API 키는 안전하게 보관하세요
# - 프로덕션 환경에서는 환경변수로 직접 설정하세요