For AI agents: a documentation index is available at the root level at /llms.txt and /llms-full.txt. Append /llms.txt to any URL for a page-level index, or .md for the markdown version of any page.
Get Started
  • Overview
    • Welcome
    • How It Works
  • Getting Started
    • Installation
    • Configuration
  • Usage
    • CLI Reference
    • Summary Styles
    • Batch Processing
    • Config Management
    • Retry Behavior
    • Errors and Troubleshooting
  • Features
    • Visual Mode
    • Transcription
    • Webapp
    • Caching
  • Integrations
    • Share a Summary
    • Cobalt
    • Proxy
    • Agent Skill
Get Started
On this page
  • Providers (summarizer.yaml)
  • API Keys (.env)
  • API Key Lookup
Getting Started

Configuration

Was this page helpful?
Edit this page
Previous

CLI Reference

Next
Built with

CLI flags override everything in summarizer.yaml. Use --no-config to ignore the config file entirely.

Providers (summarizer.yaml)

Define your LLM providers and defaults. See summarizer.example.yaml for a complete starter file.

1default_provider: gemini
2
3providers:
4  gemini:
5    base_url: https://generativelanguage.googleapis.com/v1beta/openai
6    model: gemini-flash-lite-latest
7    chunk-size: 128000
8
9  groq:
10    base_url: https://api.groq.com/openai/v1
11    model: openai/gpt-oss-20b
12
13  ollama:
14    base_url: http://localhost:11434/v1
15    model: qwen3:8b
16
17  openrouter:
18    base_url: https://openrouter.ai/api/v1
19    model: google/gemini-2.5-flash
20
21  openrouter-video:
22    base_url: https://openrouter.ai/api/v1
23    model: minimax/minimax-m3
24
25  openrouter-youtube:
26    base_url: https://openrouter.ai/api/v1
27    model: google/gemini-2.5-flash
28    visual-input-mode: url
29
30  openai:
31    base_url: https://api.openai.com/v1
32    model: gpt-5.5
33
34  nvidia:
35    base_url: https://integrate.api.nvidia.com/v1
36    model: nvidia/nemotron-3-nano-omni-30b-a3b-reasoning
37
38  perplexity:
39    base_url: https://openrouter.ai/api/v1
40    model: perplexity/sonar
41    chunk-size: 128000
42
43  litellm-anthropic:
44    base_url: litellm
45    model: anthropic/claude-sonnet-4-6
46
47defaults:
48  prompt-type: Questions and answers
49  chunk-size: 10000
50  parallel-calls: 30
51  max-tokens: 4096
52  output-language: auto
53  audio-speed: 1.0
54  use-proxy: false
55  output-dir: summaries
56  cache-transcript: true
Key defaults explained
  • output-language: auto, none, or a human-readable name like Italian, Spanish, German, Japanese.
  • audio-speed: Speed up audio before Whisper transcription. Faster and cheaper (Groq prices by audio duration), but may reduce accuracy.
  • cache-transcript: false disables the in-memory transcript cache.
  • keep-history: true persists summaries to disk for the Streamlit sidebar.

API Keys (.env)

1# Required for Cloud Whisper transcription
2groq = gsk_YOUR_KEY
3
4# LLM providers (choose one or more)
5openai = sk-proj-YOUR_KEY
6generativelanguage = YOUR_GOOGLE_KEY
7deepseek = YOUR_DEEPSEEK_KEY
8openrouter = YOUR_OPENROUTER_KEY
9perplexity = YOUR_PERPLEXITY_KEY
10hyperbolic = YOUR_HYPERBOLIC_KEY
11NVIDIA_API_KEY = YOUR_NVIDIA_KEY
12
13# Optional: Webshare proxy credentials
14WEBSHARE_PROXY_USERNAME = YOUR_WEBSHARE_USERNAME
15WEBSHARE_PROXY_PASSWORD = YOUR_WEBSHARE_PASSWORD
16
17# Optional: yt-dlp per-platform cookie files
18INSTAGRAM_COOKIES_FILE = C:\path\to\instagram-cookies.txt
19TIKTOK_COOKIES_FILE = C:\path\to\tiktok-cookies.txt
20TWITTER_COOKIES_FILE = C:\path\to\twitter-cookies.txt
21REDDIT_COOKIES_FILE = C:\path\to\reddit-cookies.txt
22FACEBOOK_COOKIES_FILE = C:\path\to\facebook-cookies.txt
23
24# Generic fallback cookie file (used when no per-platform file is set)
25YTDLP_COOKIES_FILE = C:\path\to\cookies.txt
26
27# Optional: Instagram username/password login when cookies are not used
28INSTAGRAM_USER = YOUR_INSTAGRAM_USERNAME
29INSTAGRAM_PASS = YOUR_INSTAGRAM_PASSWORD

API Key Lookup

The app resolves API keys in this order:

  1. Explicit --api-key flag
  2. Provider api_key field in summarizer.yaml
  3. .env file matched by URL keyword (e.g., generativelanguage for Google AI Studio)
  4. .env file matched by conventional env var name (e.g., NVIDIA_API_KEY, GOOGLE_API_KEY, OPENAI_API_KEY)

If a key is missing, the error message lists all acceptable .env keys for that provider.