.env.example

# GitHub Personal Access Token (required)
# Create one at: https://github.com/settings/tokens
# Required scopes: public_repo (read-only access)
GITHUB_TOKEN=YOUR_GITHUB_TOKEN

# Optional overrides (defaults shown)
# DB_PATH=./github_scout.duckdb
# LOG_LEVEL=INFO
# MAX_CONCURRENT_ENRICHMENTS=10
# GRAPHQL_ENDPOINT=https://api.github.com/graphql
# REST_BASE_URL=https://api.github.com
# DEFAULT_QUERY=language:python language:"Jupyter Notebook" stars:>100 created:>2026-01-01
# CRAWL_PAGE_SIZE=100
# MAX_PAGES=              # Omit or leave empty for unlimited (default)

# Smart re-crawl strategy
# REFRESH_TTL_HOURS=24    # Hours before a repo is considered stale (full re-enrichment)
# SNAPSHOT_TTL_HOURS=6    # Minimum hours between snapshots (avoids snapshot spam)
# FORCE_REFRESH=false     # Force full re-enrichment on all repos regardless of TTL

# Note: if the query returns >1,000 results, it is automatically split
# into date-range slices so that every matching repository is fetched.
# The created: qualifier in your query is used to determine the date range.