README.md

metadata

title: Manim GPT - AI Video Creator
emoji: 🎬
colorFrom: blue
colorTo: purple
sdk: gradio
sdk_version: 5.32.0
app_file: demo.py
pinned: false
license: mit

🎬 Manim GPT - AI Video Creator

Create beautiful explanatory animations from simple text prompts using AI and Manim!

Features

• 🤖 AI-Powered: Uses Gemini AI to generate Manim code from natural language
• 🎥 Automatic Rendering: Creates high-quality MP4 videos
• 🎵 Background Music: Automatically adds background music to all videos
• 🔄 Auto-Fix: AI automatically fixes rendering errors and lets you iterate on the result
• ⚡ Fast: Medium quality rendering for quick results

How to Use

1. Describe the concept you want to visualize (e.g. "Explain how neural networks work")
2. Click "Send" to start the generation process
3. The AI will create a scenario describing the animation
4. Press the Next Step button when you're ready to generate the Manim code
5. Wait for the video to render with background music
6. If you want changes, type a new message and the video will be regenerated
7. Download your animated explanation!

Technical Details

• AI Model: Gemini 2.5 Flash Preview
• Animation Engine: Manim Community Edition
• Video Processing: MoviePy for audio mixing
• Background Music: Automatically loops/trims to match video duration

Requirements

Set your Gemini API key as an environment variable:

export GEMINI_API_KEY="your_api_key_here"

Install dependencies (includes manim-ml for ML visualizations):

pip install -r requirements.txt

You can explore additional examples in Google's ManimML code samples.