Summarize

Transcribe and summarize videos from YouTube, Instagram, TikTok, Twitter/X, Reddit, Facebook, Google Drive, Dropbox, and local files. Works with any OpenAI-compatible LLM provider, including locally hosted endpoints.

11+ Platforms

YouTube, Instagram, TikTok, Twitter/X, Reddit, Facebook, Google Drive, Dropbox, local files

Any LLM

OpenAI, Groq, Gemini, Ollama, OpenRouter, NVIDIA, Perplexity, LiteLLM, and any OpenAI-compatible endpoint

Two Modes

Audio transcription + text summary, or visual mode sending video directly to vision-capable models

Summary Styles

Q&A, distillation, fact-checking, tutorials, Mermaid diagrams, essays, and more. Add your own instantly by editing summarizer/prompts.json.

Web UI

Streamlit interface with history, Mermaid rendering, themes, and one-click share

Docker Ready

Full-stack Compose with optional Cobalt and proxy support

Requirements

Python 3.7+
ffmpeg (must be on PATH)
At least one LLM API key in .env
Cobalt fallback downloader for URLs that yt-dlp cannot handle (included in Docker Compose). See Cobalt.

Quick Start

$ git clone https://github.com/martinopiaggi/summarize.git
$ cd summarize
$ pip install -e .
$ python -m summarizer --source "https://youtube.com/watch?v=VIDEO_ID"

The summary is saved to summaries/watch_YYYYMMDD_HHMMSS.md.

Pick Your Interface

Interface	Command
CLI	`python -m summarizer --source <source>`
Streamlit GUI	`python -m streamlit run app.py`
Docker	`docker compose up -d` → `http://localhost:8501`
Agent Skill	`.agent/skills/summarize/SKILL.md`

$	git clone https://github.com/martinopiaggi/summarize.git
$	cd summarize
$	pip install -e .
$	python -m summarizer --source "https://youtube.com/watch?v=VIDEO_ID"