Repo Explainer

Repo Explainer

Automatically generate 30-second explainer videos from any git repository using AI.

This tool analyzes your codebase, writes a script, generates cinematic video clips with Gemini VEO 3.1, adds AI voiceover, and produces a polished HD video ready to share.

Quick Install

curl -sL https://raw.githubusercontent.com/johnpsasser/repo-explainer/main/install.sh | bash

Then set up your API keys:

1. Get a Gemini API key (paid, ~$5/video)
2. Get an ElevenLabs API key (free tier available)
3. Add to your shell config:

   export GEMINI_API_KEY="your-gemini-key"
   export ELEVENLABS_API_KEY="your-elevenlabs-key"

4. Install ffmpeg: brew install ffmpeg (macOS) or sudo apt install ffmpeg (Linux)
5. Restart Claude Code

Usage

Generate a video from any repository:

/repo-explainer https://github.com/username/repo

Or use a local path:

/repo-explainer ~/dev/my-project

Preview the script without generating video (free):

/repo-explainer https://github.com/username/repo --preview

Specify output location:

/repo-explainer https://github.com/username/repo --output ~/Videos/demo.mp4

What It Does

The tool follows a five-step process:

1. Analyzes the repository by reading the README, documentation, package files, and sampling code
2. Generates a script with five 6-second scenes covering introduction, problem, solution, features, and getting started
3. Creates video clips using Gemini VEO 3.1, applying scene extension for smooth transitions
4. Generates voiceover narration using ElevenLabs
5. Composes the final video by stitching clips, layering audio, and adding background music

The result is a 30-second, 1080p MP4 file.

Cost

Per video using VEO Fast (recommended):

• VEO 3.1 Fast: $4.50 (30 seconds at $0.