How kyanitelabs/kinocut works
Kinocut is a local-first video-editing MCP server, Python client, and CLI for agent-directed editing with validation, provenance, and quality/release checks. Its primary workflow turns local interview or podcast media into captioned vertical clips for human review or publishing. The README also documents repurposing packages, podcast cuts, and agent-driven workflows. Several subsystem paths are unsampled; those capabilities are represented from the README, while edges are limited to documented relationships or source-index references.
Main entry points: media.py Python client · static_routing.py PCM routing · ingest.py Asset ingest · mix_worker.py Sound mixing
Components 28
Agent interfaces
- MCP server
kinocut/server.py - CLI runner
kinocut/cli/runner.py - Python client
kinocut/client/media.py
Media processing
- Asset ingest
kinocut/projectstore/ingest.py - Video editing
kinocut/engine.py - AI transcription
kinocut/ai_engine/transcribe.py - Subtitle rendering
kinocut/engine_subtitles.py - Shorts packages
kinocut/product/shorts_package.py - Hyperframes
kinocut/hyperframes_engine.py - Revideo bridge
kinocut/revideo_engine.py
Review and provenance
- Review and verdicts
kinocut/aivideo/review.py - Release checkpoint
kinocut/aivideo/release_surfaces.py - Video receipts
kinocut/receipts_ai_video.py - Project store
kinocut/projectstore/store.py
Audio capabilities
- Sound mixing
kinocut_sound/public/mix_worker.py - PCM routing
kinocut_sound/mix/static_routing.py - Sound limits
kinocut_sound/limits.py - Mix errors
kinocut_sound/mix/_errors.py - WAV handling
kinocut_sound/mix/_wav.py
Shared foundations
- Input validation
kinocut/validation.py - FFmpeg helpers
kinocut/ffmpeg_helpers.py - Runtime utilities
kinocut/engine_runtime_utils.py - Media probing
kinocut/engine_probe.py - Edit models
kinocut/models.py - Shared defaults
kinocut/defaults.py - Resource limits
kinocut/limits.py - Record contracts
kinocut/contracts/_common.py
Other components
- Agent or editor
Connections 19
- Agent or editor → MCP server: requests edits
README.md - Agent or editor → CLI runner: requests edits
README.md - Agent or editor → Python client: requests edits
README.md - Python client → Video editing: trims media
README.md - Python client → AI transcription: transcribes clip
README.md - Python client → Subtitle rendering: adds captions
README.md - Python client → Release checkpoint: checks export
README.md - Video editing → FFmpeg helpers: uses FFmpeg tools
README.md - Release checkpoint → Review and verdicts: quality gates
README.md - Asset ingest → Project store: writes asset records
kinocut/projectstore/ingest.py - Asset ingest → Record contracts: uses asset contract
kinocut/projectstore/ingest.py - Record contracts → Input validation: supports validation
- FFmpeg helpers → Runtime utilities: resolves executables
kinocut/ffmpeg_helpers.py - Runtime utilities → Media probing: probes media
kinocut/engine_runtime_utils.py - Sound mixing → PCM routing: routes audio
kinocut_sound/public/mix_worker.py - Sound mixing → WAV handling: reads and writes WAV
kinocut_sound/public/mix_worker.py - PCM routing → WAV handling: decodes PCM
kinocut_sound/mix/static_routing.py - PCM routing → Sound limits: enforces bounds
kinocut_sound/mix/static_routing.py - PCM routing → Mix errors: raises mix errors
kinocut_sound/mix/static_routing.py