Manim Animation Generator

This Docker-based workflow generates Manim animations based on text descriptions using the Groq API.

Prerequisites

• Docker and Docker Compose installed on your system
• Groq API key

Setup

1. Copy the .env.example file to .env.local:

   cp .env.example .env.local

2. Edit the .env.local file and add your Groq API key:

   GROQ_API_KEY=your_actual_groq_api_key
   

   Note: .env.local is gitignored to ensure your API key remains private.

Usage

1. Build and run the container:

   docker-compose up --build

2. The script will prompt you for what you want to animate

3. It will generate the animation code using Groq

4. The animation will be rendered using Manim

5. The final video will be saved in the media/videos directory

Output

The generated videos will be available in the media/videos directory on your host machine, thanks to the volume mounting in the Docker configuration.

Customization

You can modify the following files to customize the behavior:

• main.py: The main script that handles the workflow
• Dockerfile: The container configuration
• docker-compose.yml: The service configuration

Troubleshooting

If you encounter any issues:

1. Make sure your Groq API key is correctly set in the .env.local file
2. Check that Docker has sufficient resources allocated
3. Ensure all required ports are available
4. Check the Docker logs for any error messages # treehacksdockerdeploy