Turn academic papers into 3Blue1Brown-style educational videos. Fully automated.
Provide a paper, and it generates a full video with a animations and a voice over.
- Python 3.12+
- uv (package manager)
- ffmpeg (video processing)
- Claude Code installed. BEWARE OF TOKEN CONSUMPTION!!!
# Install dependencies
uv sync
# Set up ManimGL (animation engine, only needed once)
git clone https://github.com/3b1b/manim.git
cd manim && uv venv && uv pip install -e . && cd ..
# Download Kokoro TTS models (narration, only needed once)
mkdir -p models
curl -L -o models/kokoro-v1.0.int8.onnx \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/kokoro-v1.0.int8.onnx
curl -L -o models/voices-v1.0.bin \
https://github.com/thewh1teagle/kokoro-onnx/releases/download/model-files-v1.0/voices-v1.0.bin
# Run the pipeline
uv run paper2video run \
--steps config/pipeline_steps.claude.yaml \
--paper-input "https://arxiv.org/abs/..." \
--run-dir outputs/my-video