Self-host by2kb

by2kb is a command-line tool for ingesting video content into a personal knowledge base. Given a Bilibili or YouTube URL (or local media file), it retrieves the transcript — preferring native captions, falling back to audio extraction and ASR via local faster-whisper or cloud Doubao — and produces three Markdown files: a verbatim timestamped transcript, a one-minute decision-oriented abstract, and a structured long-form study guide with knowledge map, claims, evidence, and action items. The tool is designed for agent-first workflows: a Hermes plugin intercepts video URLs shared to Telegram, runs ingestion in the background, and returns the artifacts via the same chat. Users without an agent can run the same pipeline with an OpenAI-compatible API key. All artifacts are stored as portable Markdown and JSON in a local directory (default ~/.by2kb) or an Obsidian vault. The project uses SQLite for job tracking and deduplication, requires Python 3.12+, pipx, ffmpeg, and optionally Deno/Node for YouTube player challenges. No resident service or Docker image is provided; it runs as a local CLI subprocess.