BibiGPT — AI Video & Audio Summarizer
Environment Check
Run scripts/bibi-check.sh first. It detects which mode is available:
| Mode | When to use | Auth |
|---|---|---|
CLI (bibi command) | macOS / Windows / Linux with desktop app | Desktop login or BIBI_API_TOKEN |
| OpenAPI (HTTP calls) | Containers, CI, or any env without CLI | BIBI_API_TOKEN only |
If neither mode is available, see references/installation.md for setup instructions.
Intent Routing
Route the user's request to the appropriate workflow:
| User Intent | Workflow |
|---|---|
| Summarize a video/audio URL | → workflows/quick-summary.md |
| Chapter-by-chapter breakdown, detailed analysis | → workflows/deep-dive.md |
| Get subtitles, extract transcript, raw text | → workflows/transcript-extract.md |
| Turn into article, blog post, 公众号图文, 小红书 | → workflows/article-rewrite.md |
| Process multiple URLs, batch summarize | → workflows/batch-process.md |
| Research a topic across multiple videos | → workflows/research-compile.md |
| Save to Notion, Obsidian, export notes | → workflows/export-notes.md |
| Analyze visual content, slides, on-screen text | → workflows/visual-analysis.md |
Disambiguation
- If the user's intent matches more than one workflow, ask one clarifying question before routing.
- If it matches none, ask what they are trying to accomplish. Do not guess.
- If the user just pastes a URL with no context, default to
workflows/quick-summary.md.
Local File Support
The bibi CLI directly accepts local file paths (no upload needed):
bibi summarize "/path/to/video.mp4"
bibi summarize "/path/to/podcast.mp3"
For API mode (no CLI), guide the user to upload the file to a publicly accessible URL (OSS, S3, etc.) first, then pass that URL to the API. See references/supported-platforms.md for details.
Direct CLI Operations
Use progressive help to discover options: bibi --help → bibi summarize --help → run.
For simple, single-command requests that don't need a full workflow:
bibi summarize "<URL>" # Quick summary (URL or local file path)
bibi summarize "<URL>" --chapter # Chapter summary
bibi summarize "<URL>" --subtitle # Transcript only
bibi summarize "<URL>" --json # Full JSON response
bibi auth check # Check auth status
See references/cli.md for all commands and flags.
References
| Document | Contents |
|---|---|
references/cli.md | All CLI commands, flags, output formats |
references/api.md | OpenAPI endpoints, curl examples, response schemas |
references/installation.md | Desktop app install, skill install, auth setup, MCP config |
references/supported-platforms.md | Supported URL types, platform notes, duration limits |