hotclip

# HotClip — local AI clipping pipeline HotClip（AGPL-3.0 开源）把几小时的直播回放/播客/课程切成可直接发布的竖屏短视频,全程本地运行。You drive the same pipeline the desktop app uses, via a headless CLI (or the bundled MCP server). Everything — ASR, highlight detection, cutting, caption burn-in — runs on this machine; the footage is never uploaded. ## Setup (once) 1. Repo + deps (skip what already exists): ```bash git clone https://github.com/xixihhhh/hotclip.git && cd hotclip pnpm install # ffmpeg/ffprobe are bundled npm binaries — nothing else to install ``` 2. LLM config for highlight detection, via env vars (any OpenAI-compatible endpoint): ```bash export HOTCLIP_LLM_BASE_URL=http://localhost:11434/v1 # local Ollama (no key needed) export HOTCLIP_LLM_MODEL=qwen3:8b # cloud endpoints additionally need: export HOTCLIP_LLM_API_KEY=sk-... ``` If these are missing, ask the user which LLM endpoint to use — do not guess keys. 3. First `transcribe`/`clip` run auto-downloads the ASR model (~1GB, CN mirror first). Warn the user it may take a few minutes once. ## Commands (run from the repo root) ```bash pnpm cli transcribe <video> # on-device word-level ASR (cached; instant on re-run) pnpm cli highlights <video> [--max-clips N] [--reference REF] [--json] # AI highlight candidates — review before cutting pnpm cli clip <video> [--max-clips N] [--reference REF] [--no-vertical] [--no-captions] [--out DIR] [--json] # fu...