Skip to content

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

30 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

CupCat

🧁 CupCat

The free, local, AI-native video editor for Windows.

Claude edits your timeline. Everything runs on your machine. No credits, no watermark, no account.

Website License: GPL v3 Platform Release Local & free

Free Β· one installer Β· nothing else to install

Claude cutting, captioning and reframing a timeline inside CupCat
Ask in plain language β€” Claude drives the real timeline, on your machine.

CupCat is a real timeline video editor where an AI agent is a first-class editor. You describe the edit in plain language β€” "cut this 30-minute interview to a highlight reel, remove the filler, add Italian captions, make it 9:16" β€” and Claude does it directly on your timeline, using ~100 real editing tools. Almost everything runs offline on your PC: transcription, captions, dubbing, stem separation, reframing, slow-mo, motion tracking, exports.

The whole point: an AI editor that is free, local, and yours. No credit meters, no subscription gates, no cloud upload of your footage, no watermark, no account. Just a fast editor with an agent that actually operates the timeline.

Highlights

  • 🎬 The agent edits the timeline β€” ~100 real tools (cut, trim, ripple, keyframe, caption, mask, color, multicam, compound, export prep) driven by plain language.
  • πŸ”’ Local-first & private β€” your media never leaves your machine; the AI toolbox runs on-device.
  • πŸ’Έ Zero credits β€” every local feature is free and unlimited; optional generation uses your own account.
  • πŸͺŸ Windows-native β€” a single self-contained installer, no preinstalls, no Python.
  • 🧩 Open source (GPLv3).

Two ways to drive the AI

  1. In-app chat β€” talk to Claude inside the editor (Opus 4.8 / Fable 5 / Sonnet / Haiku), with @-mentions of your media, an interruptible run, and a live build-log of every tool call.

  2. Claude Code / Claude Desktop over MCP β€” CupCat exposes your open project as a local MCP server. Point any MCP client at it and edit your timeline from your own Claude:

    claude mcp add --transport http cupcat http://127.0.0.1:19789/mcp
    

Both paths share the exact same tool surface β€” editing by chatting and editing over MCP are the same engine.

What it can do

Agentic editing β€” describe an edit, get it done. First-cut assembly from a folder of footage, transcript-based text editing (delete words β†’ the video ripples), one-click filler removal ("um / uh / cioΓ¨ …"), longβ†’short clipping into vertical shorts with karaoke captions, hooks and titles, a Ctrl+K command palette that falls back to the assistant.

Local AI toolbox β€” free, offline, no credits:

Tool What it does Engine (local)
auto_rough_cut Folder of footage β†’ assembled first cut + music bed ffmpeg scene analysis
Transcript panel Edit the video by editing its text; one-click filler removal Whisper (on-device)
auto_clips Long video β†’ N vertical shorts w/ captions, hooks, titles Whisper + Claude
auto_reframe Reframe to 9:16/1:1 by tracking the subject per shot ffmpeg saliency
separate_stems Split audio into voice + music sherpa-onnx spleeter
smooth_slowmo Fluid, motion-interpolated slow motion ffmpeg minterpolate
track_motion Pin text/stickers to a moving subject template matching
dub_timeline Transcribe β†’ translate β†’ speak β†’ time-fit a dub track Whisper + Piper TTS
add_captions / translate_captions Karaoke captions + translations Whisper + Claude
add_motion_graphic / make_transition Claude writes an animated HTML/CSS overlay β†’ alpha video Edge headless + VP9
identify_speakers Speaker diarization sherpa-onnx
Semantic search_media Find clips by name, generation prompt, or what's spoken token index
blur_faces Find every face, follow it, render an anonymised copy YuNet (ONNX) + ffmpeg
stabilize_video Two-pass smoothing for handheld footage ffmpeg vidstab
auto_color Measured exposure / white-balance fix, or match another shot ffmpeg signalstats
apply_lut Grade with any .cube / .3dl LUT pack ffmpeg lut3d
match_loudness Normalise to YouTube / TikTok / podcast / broadcast targets ffmpeg loudnorm (2-pass)
repair_audio / enhance_audio Rebuild clipping & clicks; remove hiss and hum ffmpeg adeclip Β· afftdn
duck_music Music drops under speech, returns in the gaps ffmpeg sidechaincompress
auto_chapters Topic chapters + YouTube timestamps from the transcript Whisper + Claude
quality_report Pre-publish check: loudness, clipping, dead frames, flash risk ffmpeg (read-only)

Generative media β€” when you want to generate (never required, never metered by us): the agent calls Higgsfield through your own account (video, images, audio, upscaling, AI reframe, background removal).

Pro editing β€” multicam, compound clips (live nesting), adjustment layers, bezier keyframe curves, pen masks with feather, chroma key, HDR (Dolby Vision decode-once β†’ HLG HEVC export), frame-exact lossless smart-cut, beat sync, markers, rich text, custom keyboard shortcuts, screen/webcam recorder, URL import, project versioning.

Export β€” H.264 Β· H.265 Β· AV1 (10-bit) Β· HDR HEVC Β· ProRes Β· FCPXML / FCP7 XML for pro NLEs Β· lossless stream-copy. Exports are always user-initiated β€” the agent prepares the edit and hands you the Export button; it never renders on your behalf.

Install

Just want to use it: download the installer from cupcat.meetaly.agency or the latest release β€” CupCat_<version>_x64-setup.exe β€” and run it. It's a self-contained Windows app; every local engine (ffmpeg, Whisper, Piper, sherpa-onnx, YuNet) is bundled. No preinstalls, no Python, no credits. CupCat checks for new versions on launch and offers a one-click download.

To use the in-app assistant or MCP, sign in to Claude Code on the same machine. To generate media, sign in to Higgsfield (higgsfield auth login).

How it works

Claude Code / Desktop ──MCP (http 127.0.0.1:19789/mcp)──▢  CupCat bridge (bun, compiled)
In-app chat ────────────────────────────────────────────   β”œβ”€ ~100 timeline + media tools
                                                        β”‚   β”œβ”€ local AI: Whisper Β· Piper Β· sherpa-onnx Β· YuNet Β· ffmpeg
                                                        β”‚   └─ Higgsfield CLI (generate / upscale, your account)
                                                        β”‚ WebSocket (live state)
                                                        β–Ό
                              CupCat editor (React + Vite) ── @cupcat/editor-core
                              timeline Β· preview Β· media library Β· inspector Β· transcript
  • packages/editor-core β€” pure-TypeScript timeline model: commands, undo/redo, keyframes, selectors. Framework-free and unit-tested.
  • apps/web β€” the editor UI (React 19 + Vite + Tailwind).
  • apps/bridge β€” the local process: hosts the MCP server + WebSocket, runs the AI toolbox, drives Higgsfield + ffmpeg. Compiles to a single sidecar binary.
  • apps/desktop β€” the Tauri shell that bundles the bridge, the web UI, and every local engine into one NSIS installer.

Build from source

Requires Bun, Rust (for the Tauri shell), and the Windows build tools.

bun install
bun run typecheck          # editor-core + bridge + web
bun run build:core         # the shared model
bun --filter @cupcat/web build

# dev: run the web editor + bridge (uses port 19789)
bun run web
bun run bridge

The bundled AI engines (ffmpeg, Whisper/GGML models, Piper voices, sherpa-onnx models) live under apps/desktop/src-tauri/sidecars/ and are git-ignored because of their size β€” the shipped installer already contains them. To produce the installer:

cd apps/desktop/src-tauri
bunx @tauri-apps/cli build      # β†’ target/release/bundle/nsis/CupCat_<version>_x64-setup.exe

Roadmap

See ROADMAP.md for where CupCat is heading, and the releases for what already shipped.

License

GPL-3.0-or-later β€” see LICENSE and NOTICE.md. Generative AI is provided by Higgsfield via its CLI, under your own account β€” not bundled.

Made to prove an AI editor can be free, local, and yours.

About

🧁 Free, local, AI-native video editor for Windows β€” Claude edits your timeline over MCP; the AI toolbox runs on-device. No credits, no watermark.

Topics

Resources

Contributing

Security policy

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages