A blazingly fast programmatic video engine, made for agents.
Kinetograph makes videos from code, without a browser. You (or an agent) write a video in TypeScript with Remotion's
API, or as a plain HTML page. Node runs the code, and a Rust GPU compositor draws every frame: CSS, SVG, Canvas 2D,
WebGL shaders, 3D and Web Audio. Existing Remotion projects render as they are, and so do
HyperFrames projects. The film above is one TypeScript project in
examples/launch.
Kinetograph is in beta (version 0.3.0). APIs can still change between versions.
You need Node.js 22 or newer. The prebuilt package covers macOS on Apple Silicon, Linux x64 and Windows x64, and installs in about a minute with nothing else to set up:
npm install kinetograph
npx kinetograph doctorBuilding from source is only for working on the engine, or for a platform with no prebuilt package. It needs Rust and the FFmpeg libraries and takes 15 to 30 minutes: see Installation: From source.
Paste this into Claude Code, Codex or another coding agent:
Set up Kinetograph (https://github.com/0xS4N4TG/kinetograph) for me by following its AGENTS.md:
https://github.com/0xS4N4TG/kinetograph/blob/main/AGENTS.md
Ask me first whether I want the prebuilt package (recommended) or a build from source,
and ask before installing anything system-wide or installing the Kinetograph agent skills.
Start a project in an empty folder:
npx kinetograph init # TSX, Remotion-style
npx kinetograph init --html # or an HTML / HyperFrames page
npm installinit makes src/ for code (or html/ for a page), public/ for images, fonts, audio and video, and out/ for
everything Kinetograph writes. It also writes a starter title card. Render it:
npx kinetograph render src/index.tsx # writes out/renders/Main.mp4
npx kinetograph render html/index.html # for an HTML projectNode runs your project and a Rust addon draws each frame on the GPU. The Engine page walks through the six steps.
Everything else is on the docs site, kinetograph.dev/docs:
- Installation and First video
- Authoring and Remotion compatibility
- Studio, the local editor
- Use with agents
- Engine and What works
- Changelog and Contributing
Credits for the film's footage
- "Blacksmith Scene" (Edison, 1893) and "Fred Ott's Sneeze" (Edison, 1894), public domain.
- "Armistice Day Parade, Columbus, Ohio, 1927", US National Archives (archive.org/details/111-h-1555), a US government work.
- SMPTE Universal Leader, public domain.
- The handwritten "FILM" and the 16mm film burn are from licensed overlay packs ("Text Animation Overlays" and "Custom Transitions: Film Burns"); they are not in the repo.
Kinetograph is open source under the Apache License 2.0, free for any use, including commercial. Vendored crates keep their own licences (vendor/README.md).
