AI-powered video pipeline CLI. Composes videos from YAML templates by orchestrating FFmpeg, pydub, PIL, and pluggable generation backends.
QuickCut is a tool. Agents drive it. It exposes three equal-weight surfaces so any client (OpenClaw, NEMO Claw, Claude Code CLI, n8n, …) can plan → generate → build → review → iterate.
| Surface | Entry point | Use when |
|---|---|---|
| CLI | quickcut … (add --json for machine output) |
shells / CI / scripts |
| Python API | from quickcut import api |
in-process agent drivers |
| MCP server | quickcut mcp (stdio) |
any MCP-speaking client |
python -m venv .venv
.venv/Scripts/activate # Windows
# or: source .venv/bin/activate # macOS/Linux
pip install -e .[full]Dependency groups: ai, audio-pro, video-pro, vertical, upscale, rembg, full, dev.
quickcut init my-project
cd my-project
quickcut build config.yaml
quickcut review output.mp4Image, score, and voice generation dispatch to pluggable backends selected by env var (see .env.example). Dispatch walks a fallback chain so a missing key downgrades gracefully; the last resort is always a local placeholder so builds never hard-fail.
docs/agent-integration.md— wiring QuickCut into agent clients (coming)CHANGELOG.md— version historyCLAUDE.md— project memory for AI assistants working on this repo