manimator

What is manimator?

manimator is a tool to transform research papers and mathematical concepts into stunning visual explanations, powered by AI and the manim engine

Building on the incredible work by 3Blue1Brown and the manim community, manimator turns complex research papers and user prompts into clear, animated explainer videos.

🔗 Try it out:

• Gradio Demo:
• Or replace arxiv.org with manimator.hypercluster.tech in any arXiv PDF URL for instant visualizations!

🌟 Highlights so far:

• Over 1000+ uses within 24 hours of launch and over 5000 uses within a week
• Featured as Hugging Face's Space of the Week!
• 16th in Hugging Face's Top Trending Spaces

🎥 Demo Videos:

Installation

[!IMPORTANT] This project is built using the poetry tool to manage Python packages and dependencies. Download it from here to run this project or use the Docker image. This project is dependent on the manim engine and hence has certain dependencies for running the engine properly which can be found here.

bash
git clone https://github.com/HyperCluster-Tech/manimator
cd manimator

Install Dependencies: poetry install

Activate the environment: poetry env activate

(If you're using a version before Poetry 2.0, you should use poetry shell)

Usage

After successfully installing all the project dependencies and manim dependencies, set the environment variables in a .env file according to the .env.example:

Run the FastAPI server:

poetry run app

and visit localhost:8000/docs to open SwaggerUI

Run the Gradio interface:

poetry run gradio-app

and open localhost:7860

Notes

To change the models being used, you can set the environment variables for the models according to LiteLLM syntax and set the corresponding API keys accordingly.

To prompt engineer to better suit your use case, you can modify the system prompts in utils/system_prompts.py and change the few shot examples in few_shot/few_shot_prompts.py.

🛳️ Docker

To use manimator with Docker, execute the following commands:

1. Clone the manimator repo to get the Docker image (we will be publishing the image in DockerHub soon)
2. Run the Docker container, exposing port 8000 for the FastAPI server or 7860 for the Gradio interface

Build the Docker image locally. Then, run the Docker container as follows:

docker build -t manimator .

If you are running the FastAPI server

docker run -p 8000:8000 manimator

Else for the Gradio interface

docker run -p 7860:7860 manimator

{
  "status": "ok"
}

curl http://localhost:8000/health-check

{
  "scene_description": "Generated scene description based on PDF content"
}

curl -X POST -F "file=@/path/to/file.pdf" http://localhost:8000/generate-pdf-scene

{
  "scene_description": "Generated scene description based on arXiv paper"
}

curl http://localhost:8000/pdf/2312.12345

{
  "prompt": "Your scene description prompt"
}

{
  "scene_description": "Generated scene description based on prompt"
}

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"prompt": "Explain how neural networks work"}' \
     http://localhost:8000/generate-prompt-scene

{
  "prompt": "Your animation prompt"
}

curl -X POST \
     -H "Content-Type: application/json" \
     -d '{"prompt": "Create an animation explaining quantum computing"}' \
     --output animation.mp4 \
     http://localhost:8000/generate-animation

{
  "detail": "Error description"
}

Coming Soon

• Improved Generation Quality
  Enhance the clarity and precision of generated animations and videos.

• Video Transcription
  Automatically generate scripts explaining how concepts in the video relate to the research paper.

• Adding Audio
  Support for adding voiceovers and background music to create more engaging visualizations.

• Chrome Extension Based on the code graciously contributed by Dr. Seth Dobrin under the Creative Commons License, we will be releasing a Chrome Extension on the Chrome Web Store soon!

Limitations

• LLM Limitations
  For accurate document parsing and code generation, we require large models like Gemini, DeepSeek V3 and Qwen 2.5 Coder 32B, which cannot be run locally.

• Video Generation Limitations
  The generated video may sometimes exhibit overlap between scenes and rendered elements, leading to visual inconsistencies. Additionally, it sometimes fails to effectively visualize complex papers in a relevant and meaningful manner.

License

manimator is licensed under the MIT License. See LICENSE for more information. The project uses the Manim engine under the hood, which is double-licensed under the MIT license, with copyright by 3blue1brown LLC and copyright by Manim Community Developers.

Acknowledgements

We acknowledge the Manim Community and 3Blue1Brown for developing and maintaining the Manim library, which serves as the foundation for this project. Project developers include: Samarth P, Vyoman Jain, Shiva Golugula, and M Sai Sathvik for their efforts in developing manimator.

Models and Providers being used:

• DeepSeek-V3
• Llama 3.3 70B via Groq
• Gemini 1.5 Flash / 2.0 Flash-experimental

Contact

For any inquiries, please contact us at hypercluster.tech@gmail.com or refer to our website hypercluster.tech