A local-first AI editing workflow for talking-head and content videos
From script or footage
to a publishable cut.
Kacha is a local, AI-assisted, evidence-driven video production workflow. It turns planning, editing, mixing, packaging, and revision into a recoverable project while people retain editorial, review, and publishing responsibility.
01Media stays local by default02Complete meaning stays intact03Every change is traceable
LOCAL
VIDEO
SYSTEM
KACHA / RUN_001VERIFIED
STORY
VOICE
VISUAL
QC
Not a one-shot generation—four checkpoints you can inspect, leave, and resume01 / 04
01 / PROBLEMS
The timeline is not the only expensive part.
People looking at AI editing are rarely missing another effect. They worry that automation will cut the meaning, damage the voice, scramble captions, and still leave them rebuilding the video by hand.
The pause is gone—and so is half the sentence
Silence-only cutting can damage negation, conditions, causality, and conclusions. Meaning must lead every cut.
Voice, captions, and visuals drift apart
Tool chains create timing drift. Dialogue, music, SFX, captions, and picture need the same frame boundaries.
More effects, less visual coherence
Captions, cards, PIP, and transitions become a collage unless one design system governs them.
One small change triggers a full rebuild
A caption, mix, or local visual revision should not invalidate the whole project. The workflow must know what changed.
02 / RESULTS
See the change before the feature list.
Kacha turns the results viewers actually notice into editing contracts that can be executed and checked.
Common failureKacha treatment
STRUCTURE
Tighter, without cutting the thought
Remove dead pauses, mistakes, and repetition while preserving complete meaning, natural emphasis, and comic timing.
Every cut checks semantics, breath, picture continuity, and handles.Common failureKacha treatment
AUDIO + CAPTIONS
Clear to hear and easy to read
Diagnose and listen first, then pass through, lightly process, or separate dialogue as needed. Speech leads caption timing while the script calibrates names, numbers, and context.
Dialogue, captions, music, and SFX share one timing contract.Common failureKacha treatment
VISUAL SYSTEM
Motivated effects, coherent frames
Cards, PIP, masks, emphasis, and transitions appear only when information, emotion, or viewpoint changes.
Typography, color, radius, shadow, motion, and avoidance share one system.Common failureKacha treatment
INCREMENTAL REWORK
Feedback without a full rebuild
Compile notes into a delta, cover every change in at most three preview groups, and rebuild only the affected layer.
Freeze unrelated streams, strongly fingerprint expensive artifacts, and prove unchanged layers stayed unchanged.These are capability diagrams. See the 行者大灰 channels below for real videos and ongoing demonstrations.
03 / EDITING GRAMMARS
Start with the story. Shape your own expression.
Decide what the viewer should understand, then combine narrative methods, visual form, and production tools. Beyond these five examples, use demonstrations, comparisons, montage, sound bridges, artistic scenes, or a custom method. Live footage, illustration, 3D, and minimal typography are creative directions; evidence, brand rules, and dialogue protection still apply.
0102
EDITORIAL CONTINUITY
Focused Annotation
Keep the talking-head thought continuous. Add one edge note and a restrained evidence zone instead of interrupting the speaker with a dashboard.
- 01complete thought
- 02margin note
- 03evidence
- 04clean A-roll
DEPTH NAVIGATION
Relations & Mechanisms
Map a real relationship, then guide attention with lines, camera movement, or diagrams. Light paths and hand-drawn sketches are optional visual treatments.
- 01establish relation
- 02guide attention
- 03explain mechanism
- 04whole picture
01…!
COMEDIC TIMING
Comic Timing
Panels appear only when a real contrast exists. Setup, silence, reaction, punchline, and callback create the joke—not a comic filter.
- 01setup
- 02half-beat hold
- 03reaction
- 04punchline
- 05callback
INPUTRULEPASS
STATE MACHINE
State Change
Organize real changes around input, rules, and outcomes. Pixels, live footage, screen recordings, and simple diagrams can all express a state change.
- 01input
- 02rule
- 03state commit
- 04verified result
EVIDENCE 01VERIFIED
FORENSIC REVEAL
Evidence Reveal
Move from a baseline to evidence, then a supported judgment and its uncertainty. Book pages, source screenshots, and focused framing work without a dark-tech treatment.
- 01clean baseline
- 02isolate anomaly
- 03lock evidence
- 04verdict
- 05restore context
OPEN CREATIVE DIRECTIONDevelopment channel · Combine or customize methods. Four creative tool adapters require their dependencies; generated candidates are reviewed per version.
04 / CAPABILITIES
Finishing a video takes these capabilities working together.
Kacha is not a collection of isolated AI features. It keeps content, sound, visuals, captions, and quality checks in one shared context.
CONTENT EDIT
Structure and fine cut
Find mistakes, repetition, rambling, and dead pauses without damaging meaning or natural delivery.
VOICE & SOUND
Dialogue and mix
Dialogue separation, cleanup, enhancement, music, SFX, and loudness serve long-listening comfort.
CAPTIONS
Caption calibration
Speech leads, scripts calibrate, and names, numbers, semantic breaks, line length, and bilingual hierarchy are checked.
VIDEO DESIGN SYSTEM
Visual packaging
One system drives captions, cards, PIP, diagrams, masks, openings, transitions, covers, and motion.
OPTIONAL PORTRAIT
Restrained portrait polish
Built-in beauty has been removed. Beauty tasks use the Jianying Pro workflow with entitlement checks and before/after review.
FAIL-CLOSED QC
Quality gates
Check decode, tracks, geometry, loudness, sync, black frames, and silence clues before the human watch-through.
GLOBAL DIRECTOR
Project orchestration and direction
Keep runtime, source identity, story structure, quiet budget, and current evidence in one resumable project. Schedule work by its actual dependencies.
SEMANTIC REVIEW
Unified decision and release review
Review high-impact decisions in verified 1x video/audio, then complete eleven checks bound to the current final-video hash. Adjustments create traceable revision requests.
CONTENT FIRST
Script-to-recording handoff
Start without footage: build a content spine, fact-check queue, recording plan, and asset list. Unresolved facts or assets block the editing handoff.
ASSET INBOX
Asset gap inbox
Separate factual evidence, user-provided media, and illustrative generation candidates. License, provenance, file identity, and reindexing remain mandatory.
QUALITY-PRESERVING EFFICIENCY
Faster iteration and waiting—not weaker judgment
Current evidence selects opening, typical, complex, and ending ranges. Independent work runs in resource-safe waves while the full candidate still requires a normal-speed watch-through.
05 / WORKFLOW
Start with a script or footage. Confirm four milestones.
Four user milestones keep decisions clear. New projects follow actual dependencies and rebuild only affected work. Completion binds to current inputs and real evidence; existing projects retain their contracts.
- 01CONFIRM
Proposal confirmed
Freeze runtime, source identity, show, and authority; complete the content spine, transcript, director plan, and asset gaps.
inventory · transcript · structure - 02CONFIRM
First cut confirmed
Complete rough cut, dialogue preprocessing, every connection check, and fine cut across meaning, lip sync, action, and rhythm.
rough cut · dialogue · connections · fine cut - 03REVIEW
Candidate reviewed
Finish visuals, captions, mix, cover, representative previews, semantic review, and technical QC in one review center.
package · captions · mix · cover · QC - 04APPROVE
Delivery and revision
Bind eleven checks to the current final hash. Compile feedback into a delta; never upload, pay, or publish without separate authority.
release checklist · delta · local delivery
RECOVERABLE STATE
AWAITING EXPLICIT LOCAL RELEASE APPROVAL06 / WHY KACHA
“AI handles repetition. You keep the final judgment.”
Kacha does not call one generation a final video or a technical pass a human approval. Its advantage is not choosing taste for you—it makes each decision easier to execute, verify, and revise.
Local first
Media stays local by default. External transfer, paid generation, and publishing need explicit authorization.
Controllable process
Plans, configuration, asset provenance, change scope, and QC evidence remain available when something goes wrong.
Verifiable quality
Preview, candidate, automated checks, human review, and publication are separate states.
07 / FIT
Built first for these videos and creators.
Kacha prioritizes people who need to preserve real human delivery while reducing repetitive post-production work.
Talking-head and knowledge videos
Remove mistakes and pauses while protecting logic, tone, expression, and natural rhythm.
Tutorials, interviews, and video podcasts
Long-form structure, clean dialogue, accurate captions, information graphics, and platform versions.
Consistent personal brands
A reusable visual system, scenes, covers, and lower-cost revisions for ongoing publishing.
Codex or Claude Code teams
Use an Agent to execute a local production, inspection, and delivery contract—not just offer suggestions.
08 / FAQ
What people usually ask before they start.
Privacy, control, quality, and limits deserve a clear answer before any “one-click” promise.
01Will Kacha upload my footage?＋
Not by default. Kacha prefers local tools. Files leave the machine only when external media, cloud generation, or publishing is necessary and explicitly authorized.
02Will it cut a sentence in half or make the pacing feel fake?＋
Fine cuts cannot rely on silence thresholds alone. Kacha checks complete meaning, breath, expression, picture continuity, and handles; the current candidate still requires a human watch-through.
03Can it preserve source quality and geometry?＋
By default it preserves pixel dimensions, aspect ratio, effective frame rate, and the color contract. Incremental work freezes or copies unrelated streams where possible; re-encoding depends on the requested change.
04Can I keep editing the result myself?＋
Yes. Kacha keeps plans, configuration, deltas, and intermediate assets so an Agent can continue incrementally or an existing NLE can take over.
09 / START
Give Kacha to your Agent.
Kacha supports Codex and Claude Code. Describe your media, goal, and constraints in plain language; Kacha establishes the plan and boundaries before production starts.
CODEXCLAUDE CODELOCAL FIRST
~/install-kacha
curl -fsSL https://raw.githubusercontent.com/colorcross/kacha/main/scripts/install.sh | bash -s -- --agent both --channel canaryThis command explicitly installs canary (tracking main). Replace canary with stable for the release line, which currently remains v1.2.0. Requires Node.js 20+; the full media workflow also needs FFmpeg and FFprobe. The installer will not overwrite an existing version.
10 / CONTACT
See real results or contact me directly.
行者大灰 publishes real Kacha edits, before-and-after comparisons, and production reviews. Follow on the platform you use, or email questions, collaboration ideas, and feedback.
Emaildodofun@126.comScan to see real video results
