The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the Envie listing page.
AI video, verified.
Describe a video to your AI. Get a real file back.
Envie gives Claude Code and any MCP client a deterministic render engine: headless Chrome filmed frame by frame, six verification gates, and a full read-back layer. Free. No watermark. No account.
By GOL Productions.
AI can write code. AI can describe video. But AI can't see what it made—so it guesses, you render, it's wrong, you describe what's wrong, repeat.
Envie renders what your AI writes, verifies it machine-checks, and lets your AI see the result. No guessing.
Detects Claude Code, Cursor, Windsurf—registers with all of them. Then just ask:
"Make me a 15-second vertical launch video for my app"
Or for Claude Code:
Your AI reads envie_guide and writes a composition: one self-contained HTML file with CSS animations, WebGL, Canvas, GIFs—whatever the browser can render.
envie_render films it deterministically. Headless Chrome with a virtualized clock: performance.now(), Date.now(), requestAnimationFrame, setTimeout—all seeked frame by frame.
Same composition = same video. Every time.
Six gates machine-check the result before delivery:
| Gate | What it checks |
|---|---|
| G1 | File exists, valid container, ≥2.9s duration |
| G2 | Has both video and audio streams |
| G3 | Audio isn't silent (mean > -50dB) |
| G4 | No black segment > 2 seconds |
| G5 | No freeze > 8 seconds, < 60% total still time |
| G6 | Final 15% isn't dead (frozen or black) |
A failing video comes back marked FAILED, with the gate report and an instruction not to deliver it, so your AI fixes the composition and renders again.
envie_see returns frames at chosen timestamps so your AI can judge layout and pacing—not just whether the file exists.
envie_translate reads the finished file as data: per-frame motion, every cut and fade, still holds, LUFS, true peak, and how each audio hit sits against the nearest picture event.
| Requirement | Notes |
|---|---|
| Node 24+ | Or later |
| Chrome | Or set ENVIE_CHROME to your binary |
| ffmpeg + ffprobe | Must be on PATH |
| Audio | Required. Videos with no audio fail G2 and G3 |
| Option | Platform | Description |
|---|---|---|
--narration "text" | Windows only | Local TTS voiceover (SAPI) |
--audio file.wav | All platforms | Overlay any wav/mp3/m4a |
Runs entirely on your machine. Nothing reaches GOL servers.
| Flag | Container | Codec |
|---|---|---|
--format h264 | .mp4 | libx264 (default) |
--format h265 | .mp4 | libx265 10-bit |
--format prores | .mov | ProRes 422 HQ 10-bit |
--format prores4444 | .mov | ProRes 4444 10-bit |
--format dnxhr | .mov | DNxHR HQ |
envie here means npx @golproductions/envie@latest. Use @latest: plain npx runs an older globally installed copy if one exists.
One self-contained HTML file:
| Attribute | Description |
|---|---|
data-duration-ms | Video length in milliseconds (3000–300000) |
data-width | Canvas width (default: 1920) |
data-height | Canvas height (default: 1080) |
Everything the browser can animate:
requestAnimationFramesetTimeout, setIntervalperformance.now(), Date.now(), new Date()Math.random(), crypto.getRandomValues (seeded)NOT virtualized (avoid):
Declare what the composition must achieve:
| Assertion | Meaning |
|---|---|
data-expect-sync-ms="120" | Audio hits must land within 120ms of a picture event |
data-expect-no-holds-longer-than="3" | No still hold may exceed 3 seconds |
Failures are reported test-style:
The render engine virtualizes time itself:
This is how the same HTML produces the same video, every render.
Same machine + same Chrome version + same composition = bit-identical output.
Cross-environment, you may see variation from:
The guarantee is reproducibility on your machine, not cross-platform bit-identity. That's the right scope: your AI iterates locally, re-renders, gets the same result.
GOL claims no ownership over your compositions or videos. Envie runs on your machine. Nothing you make reaches us.
Free to use, personal or commercial, under the GOL Free License. Envie is built by GOL Productions: you may use it and share unmodified copies with the credit, but not publish changed versions, build your own product from it, or sell it. What you make with it is yours. See LICENSE.
Envie is part of the GOL Productions toolchain.