clipforge / .env.example
moonlantern1's picture
Document OpenRouter backup key setting
9b1e0cd verified
# Copy to ".env" in the project root (or export in your shell). See docs/ENVIRONMENT.md.
# --- Gemini / OpenRouter (clip selection + hooks + layout vision) ---
# Choose the backend explicitly. Recommended for this pipeline: openrouter.
HUMEO_LLM_PROVIDER=openrouter
# Google AI Studio key (only needed when HUMEO_LLM_PROVIDER=google or auto).
GOOGLE_API_KEY=
# Legacy alias — only used if GOOGLE_API_KEY is unset:
# GEMINI_API_KEY=
# Recommended backend for all Gemini stages:
OPENROUTER_API_KEY=
# Optional fallback used if the primary OpenRouter key errors or returns empty text.
OPENROUTER_API_KEY_BACKUP=
# Model ids (override per run with: humeo ... --gemini-model <id>)
GEMINI_MODEL=google/gemini-2.5-pro
# Optional override for layout vision; leave blank to reuse GEMINI_MODEL.
# GEMINI_VISION_MODEL=google/gemini-2.5-pro
# Optional zip or directory with the viral hook library corpus.
# HUMEO_HOOK_LIBRARY_PATH=C:\Users\you\Downloads\5000_viral_hooks.zip
# Optional: directory with clip_selection_system.jinja2 and clip_selection_user.jinja2
# HUMEO_PROMPTS_DIR=
# --- Transcription ---
# Recommended default: ElevenLabs Scribe v2 with No Verbatim cleanup.
ELEVENLABS_API_KEY=
ELEVENLABS_NO_VERBATIM=true
HUMEO_TRANSCRIBE_PROVIDER=elevenlabs
# Optional fallback if you deliberately use the OpenAI Whisper API instead.
# OPENAI_API_KEY=sk-...
# Optional local fallback:
# HUMEO_TRANSCRIBE_PROVIDER=whisperx
# --- Tracking fallback ---
# REPLICATE_API_TOKEN=
HUMEO_SEGMENTATION_PROVIDER=replicate
# HUMEO_SEGMENTATION_MODEL=meta/sam-2-video
# --- YouTube downloads on cloud hosts ---
# Hugging Face/cloud IPs are sometimes blocked by YouTube. If link downloads fail
# with a bot/sign-in message, export browser cookies in Netscape cookies.txt format,
# base64 encode the file, and set this as a Hugging Face Space secret.
# YTDLP_COOKIES_B64=
# Advanced yt-dlp override:
# YTDLP_EXTRACTOR_ARGS=youtube:player_client=default,web_creator
# --- Video cache (optional) ---
# Override default: ~/.cache/humeo (Unix) or %LOCALAPPDATA%/humeo (Windows)
# HUMEO_CACHE_ROOT=