# =========================================== # 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 키는 안전하게 보관하세요 # - 프로덕션 환경에서는 환경변수로 직접 설정하세요