src/envs.py

import os

from huggingface_hub import HfApi

# Info to change for your repository
# ----------------------------------
TOKEN = os.environ.get("TOKEN")  # A read/write token for your org


# ----------------------------------

OWNER = "qanta-challenge"

REPO_ID = f"{OWNER}/quizbowl-submission"
QUEUE_REPO = f"{OWNER}/advcal-requests"
RESULTS_REPO = f"{OWNER}/advcal-results"
LLM_CACHE_REPO = f"{OWNER}/advcal-llm-cache"
USERS_REPO = f"{OWNER}/registered-users"

ADMIN_USERS = ["mgor"]
EVAL_SPLITS = {"Week 2": "w2_eval", "Week 1": "w1_eval", "Week 0": "tiny_eval"}
CUTOFF_DATES = {"Week 1": "2025-05-30", "Week 0": "2025-05-23", "Week 2": "2025-06-10"}


# Important Links
QANTA_WEBSITE_URL = "https://sites.google.com/view/qanta/home"
COMPETITION_URL = "https://sites.google.com/view/qanta/2025-competition"
DOCS_REPO_URL = "https://github.com/qanta-challenge/QANTA25"
DOCS_URL = DOCS_REPO_URL + "/tree/main"
GITHUB_ISSUES_URL = DOCS_REPO_URL + "/issues"

CONTACT_EMAIL = "qanta@googlegroups.com"
DISCORD_URL = "https://discord.gg/ChmDVatJ6Y"
REGISTRATION_URL = "https://huggingface.co/spaces/qanta-challenge/register"
SUBMISSION_URL = "https://huggingface.co/spaces/qanta-challenge/quizbowl-submission"
EXAMPLES_PATH = "examples"


# ----------------------------------

# If you setup a cache later, just change HF_HOME
CACHE_PATH = os.getenv("HF_HOME", ".")

# Local caches
LLM_CACHE_PATH = os.path.join(CACHE_PATH, "llm-cache")
USERS_PATH = os.path.join(CACHE_PATH, "registered-users")
EVAL_REQUESTS_PATH = os.path.join(CACHE_PATH, "eval-queue")
EVAL_RESULTS_PATH = os.path.join(CACHE_PATH, "eval-results")
EVAL_REQUESTS_PATH_BACKEND = os.path.join(CACHE_PATH, "eval-queue-bk")
EVAL_RESULTS_PATH_BACKEND = os.path.join(CACHE_PATH, "eval-results-bk")


LLM_CACHE_REFRESH_INTERVAL = 600  # seconds (30 minutes)
SERVER_RESTART_INTERVAL = 2 * 24 * 60 * 60  # seconds (2 days)
LEADERBOARD_REFRESH_INTERVAL = 600  # seconds (10 minutes)

API = HfApi(token=TOKEN)