Manim Animation Generator

Overview

Manim Animation Generator is a web platform that allows users to create custom 3D animations using natural language prompts.

Users describe an animation in plain English, which is converted into Python code using large language models and rendered using the Manim library on a secure cloud environment. The final animation is delivered as an MP4 file.

The system is designed with security, scalability, and automation in mind.

---

Architecture

The application follows a distributed rendering pipeline:

1. User submits a prompt from the web interface
2. Prompt is processed by an LLM (Ollama, GPT, or NVIDIA NIM)
3. Generated Python code is validated and sandboxed
4. Code executes on an isolated AWS EC2 instance
5. Manim renders the animation
6. Output video is uploaded to AWS S3
7. User receives a downloadable streaming link

This architecture prevents arbitrary code execution on the main server.

Tech Stack

Frontend

• Next.js: For fast development and optimized production builds
• TypeScript: Ensuring type safety and better developer experience
• Tailwind CSS + Shadcn UI: For rapid UI development with consistent design

Backend

• Python: Powers the core server infrastructure
• FastAPI: Exposes internal API for execution of generated code
• PostgreSQL: Handles data persistence with flexible schema
• NextAuth: Handles authentication and user management

---

Key Features

Prompt-to-Animation Pipeline

• Converts natural language into Manim scripts
• Supports multiple LLM providers
• Validates generated code before execution

Secure Rendering Environment

• Isolated EC2 sandbox for execution
• Restricted permissions and resource limits
• Automatic cleanup after rendering

Authentication & User Management

• Google OAuth integration
• Session-based authentication
• User-specific animation history

Data Storage

• Stores prompts, generated code, and video URLs
• PostgreSQL-backed persistent storage
• Optimized query indexing

Automated Deployment

• CI/CD pipeline for EC2 deployment
• Automatic builds and container updates
• Zero-downtime updates