Cutpoint

Cutpoint is an AI video editor that your coding agent drives. Tell the agent to edit a video and it finds the best moments, cuts them into clips and assembles the result. All analysis runs on your own computer, so your agent does not spend API credits on video, and your original files are never changed.

Are you an AI agent? Start here

(Installed from PyPI? Run cutpoint guide.)

What you get

• Trimmed, numbered clips of the best moments
• A transcript of the video with timestamps
• A finished video, final.mp4, plus timelines you can open in DaVinci Resolve
• Vertical (9:16) versions for shorts and reels
• Works on gameplay, action-cam, sport, funny moments, commentary and 360 video

Use it

1. Install Cutpoint (below).

2. Open your agent (Claude Code, Codex, Grok CLI or any CLI agent) in the Cutpoint folder, or tell it where Cutpoint is.

3. Ask it to edit your video:

   Edit D:\Videos\clip.mp4 into a 60 second highlights video with Cutpoint.

   Find the funniest moments in ~/Videos/stream.mp4 and show me the clips before you assemble them.

   Make a vertical montage from ~/Videos/ride.mp4.

The agent runs Cutpoint, shows you the clips and writes the result into a project folder. Delete or rename clips to change the cut, then ask the agent to assemble again.

One-command editing (cutpoint edit), a first-run setup wizard and an agent skill are planned. Today the agent runs the steps itself using AGENTS.md.

Requirements

• Windows or Linux
• Python 3.12 and uv
• ffmpeg
• An NVIDIA GPU is recommended. Without one, everything still runs but slower.
• Optional: Ollama for AI frame rating, extra downloads (about 8 GB) for sound, on-screen text and scene-description features

Install

winget install --id Gyan.FFmpeg -e
winget install --id astral-sh.uv -e
git clone https://github.com/FerventOrange/cutpoint.git
cd cutpoint
uv sync
uv run cutpoint paths

To get a global cutpoint command instead, run uv tool install cutpoint (from PyPI) after installing ffmpeg and uv.

On Linux, install ffmpeg and uv with your package manager or their installers, then run the last four commands. The optional extras and model downloads are explained in Getting started.

Documentation

• Getting started: install, first run, where data is stored, models
• Using Cutpoint from an agent: set up Claude Code, Codex, Grok or another agent
• Workflows: montages, game streams, action-cam, 360 video, vertical output
• Command reference
• Configuration
• Troubleshooting
• FAQ
• Architecture, Contributing, Security
• Insta360 SDK: optional, for high-quality 360 stitching

License

Cutpoint is released under the MIT License.