Video Summarizer

Documentation ·

Local-first, multi-source video summarization for YouTube, social platforms, cloud drives, and local files. Works with any OpenAI-compatible LLM, supports an optional vision path, and includes NotebookLM-style workflows.

Not steipete/summarize. This project is a self-hosted video pipeline with transcript caching, Cobalt fallback, a Streamlit workspace, and an agent skill. steipete/summarize is a generic URL clipper.

Bring your own API keys. Configuration lives in summarizer.yaml and .env. Full documentation: summarize.martino.im.

Features

• 11+ sources — YouTube, Instagram, TikTok, X/Twitter, Reddit, Facebook, Google Drive, Dropbox, and local files
• Any LLM — OpenAI, Groq, Gemini, Ollama, OpenRouter, NVIDIA, Perplexity, LiteLLM, and other OpenAI-compatible endpoints
• Two modes — Transcript-based summarization (default) or visual mode with vision-capable models
• Summary styles — Q&A, distillation, fact-checking, tutorials, Mermaid diagrams, essays, and custom prompts via summarizer/prompts.json
• Multiple interfaces — CLI, Streamlit UI, HTTP API, Docker, Raycast extension, and agent skill
• Transcript cache — Reuse cached transcripts across runs; optional Cobalt sidecar for yt-dlp fallbacks

Requirements

• Python 3.7+
• ffmpeg on PATH
• At least one LLM API key in .env
• Cobalt (optional, included in Docker Compose) for URLs that yt-dlp cannot handle

Quick Start

Set an OpenAI-compatible API key in .env. Groq (GROQ_API_KEY) offers a free tier; OPENAI_API_KEY works with --provider openai.

pip install martino-summarize
summarizer --init-config
echo "GROQ_API_KEY=your_key_here" > .env
summarizer --source "https://www.youtube.com/watch?v=arj7oStGLkU"

Summaries are saved to summaries/watch_YYYYMMDD_HHMMSS.md.

Optional extras:

pipx install "martino-summarize[server]"   # HTTP API
pipx install "martino-summarize[all]"      # server + whisper + litellm

Docker

git clone https://github.com/martinopiaggi/summarize.git
cd summarize
cp summarizer.example.yaml summarizer.yaml   # first time only
echo "GROQ_API_KEY=your_key_here" > .env     # or OPENAI_API_KEY, etc.
docker compose up -d

Open http://localhost:8501, paste a URL, and summarize.

Pre-built image:

docker pull ghcr.io/martinopiaggi/summarize:latest

docker-compose.yml mounts .env, summarizer.yaml, and ./summaries/ for persistence. Cobalt runs as a sidecar for TikTok, Instagram, and other yt-dlp fallbacks.

Interfaces

How It Works

• Transcript path (default): downloads audio or video, transcribes with Whisper or captions, caches the transcript, then summarizes with an LLM.
• Visual path (--visual): sends the video directly to a vision-capable model, skipping transcription. Uses the same prompts, provider config, and .env keys as the transcript path. Supports base64 chunks (default) and url passthrough for YouTube.

Full pipeline diagram: summarize.martino.im/how-it-works

Troubleshooting

Full guide: summarize.martino.im

Contributing

git clone https://github.com/martinopiaggi/summarize.git
cd summarize
pip install -e ".[all]"
pip install pytest
pytest tests/

See CONTRIBUTING.md.

License

MIT