README.md

metadata

title: PDF → Manim → LLM App
emoji: 🎬
colorFrom: red
colorTo: blue
sdk: gradio
sdk_version: 6.8.0
python_version: '3.11'
app_file: app.py
pinned: false

🎬 PDF → Manim Animation Pipeline

Upload a PDF → Gemini generates a Manim animation → watch it in-app and download the artifacts.

---

🚀 Deploy on Hugging Face Spaces

1. Create a new Space (SDK: Gradio, any CPU hardware).
2. Upload all files in this folder.
3. No secrets required — users supply their own Gemini API key in the UI.

---

🖥️ Usage

1. Upload a PDF.
2. Enter your Gemini API key (saved in your browser — enter once).
3. Click Generate Video.
4. Watch live status and the generated Manim code appear in real time.
5. When complete:
   • ▶️ Video player — watch the animation directly in the browser.
   • ⬇️ Artifacts ZIP — download <job_id>.py + OutputVideo.mp4.

---

🏗️ Architecture

PDF Upload
    │
    ▼
Extract Text (pypdf)
    │
    ▼
Gemini 3 Flash Preview  →  code shown live in UI
    │
    ▼
Manim Render (-qm, 1280×720, 30fps)
    │
    ▼
Video Player + artifacts_<job_id>.zip download

---

📁 File Structure

.
├── app.py              # Gradio UI — streaming status, video player, zip download
├── pipeline.py         # Job orchestrator
├── queue_manager.py    # Thread-pool queue (max 100 jobs)
├── utils.py            # PDF extraction, Gemini streaming, code sanitisation
├── requirements.txt    # Python deps
├── packages.txt        # System deps (LaTeX, ffmpeg, cairo…)
└── README.md

---

⚙️ System Packages (packages.txt)

Manim requires LaTeX and ffmpeg. These are installed automatically by HF Spaces:

• ffmpeg, libcairo2-dev, libpango1.0-dev
• texlive-latex-base, texlive-latex-extra, texlive-fonts-recommended
• dvipng, dvisvgm, ghostscript

---

🐛 Troubleshooting

Issue	Fix
latex not found	Ensure packages.txt is at the repo root
Render timeout	Use higher-tier hardware or shorten animation in prompt
Gemini API error	Check API key and quota at aistudio.google.com
Empty PDF	PDF must have selectable text (not a scanned image)