bibi

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.

Payment fallback (China): if neither auth is set but the user has an Alipay account, BibiGPT may emit HTTP 402 Payment Required with a Payment-Needed header (AI 收 protocol). The agent can resolve this automatically by installing @alipay/agent-payment, or manually by directing the user to a one-off QR purchase. See references/billing-aipay.md.

Detect 402 deterministically: the bibi CLI prints a stable marker line [HTTP/402 Payment Required] to stderr before any human-readable prompt; direct HTTP callers get status 402 + Payment-Needed header. When either signal appears, route to references/billing-aipay.md instead of treating the call as failed.

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
Turn into TikTok / Reels / Shorts-style music video	→ workflows/video-to-tiktok-mv.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
Check current account, plan, or remaining minutes	→ workflows/account-check.md
Browse / search saved videos, "what have I summarized"	→ workflows/library-browse.md
Manage channel subscriptions, list/sub/unsub, RSS preview	→ workflows/channels-manage.md
What's new across my subscriptions, latest feed, daily digest	→ workflows/feed-latest.md
Manage collections, list/create/share saved videos as a set	→ workflows/collections-manage.md
Manage personal notes on saved videos, edit summaries	→ workflows/notes-manage.md
Generate mindmap, visual analysis, custom-prompt summary, Notion export, collection chat	→ workflows/advanced-tools.md
HTTP 402 / "需要付款" / Alipay AI 钱包 / no token + China user	→ references/billing-aipay.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
bibi me                             # Get account, plan, remaining minutes
bibi commands                       # List all manifest-driven commands

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
references/billing-aipay.md	Alipay AI收 (HTTP 402) per-call payment fallback for China users