showtell
v0.2.0
Published
Open-source motion engine for videos made by agents, for humans.
Maintainers
Readme
showtell
Agents don't just tell. They show.
Showtell is an open-source motion engine for videos made by agents, for humans. Agents author structured intent and deterministic browser HyperFrames in HTML, CSS, and JavaScript; Showtell renders narrated MP4s from code, diffs, data, maps, screenshots, images, and other declared inputs.
Install
npm install --global showtell
showtell versionShowtell supports Apple Silicon macOS and glibc-based Linux on x64 or ARM64. It installs one self-contained native binary plus the pinned Chromium runtime for your platform; Bun and a separate browser install are not required. Rendering requires ffmpeg.
macOS:
brew install ffmpegUbuntu/Debian:
sudo apt-get update && sudo apt-get install -y ffmpeg espeak-ngQuick start
Install the bundled agent skill:
showtell skill install
# Codex: showtell skill install --dir ~/.codex/skillsThen ask your agent: “Make me a showtell of this PR.”
The source, examples, and complete documentation live in the Showtell repository.
Linux note
The default local say provider uses espeak-ng on Linux. OpenAI, Replicate, and ElevenLabs are also available through environment API keys. Screen recording is currently macOS-only; rendering existing screenshots and screencap files works on Linux.
License
MIT
