How fawmeen/manimai works
AI-Math-Tutor accepts a topic, routes it through a FastAPI/LangGraph workflow, reuses cached animations when possible, and otherwise generates and renders Manim or Matplotlib video. The Manim path can add a transcript and audio before merging them; results are returned as media URLs. The README also describes planning and self-healing capabilities, though the sampled workflow does not show a planner stage or its retry loop. Frontend source is present, but its connection to the API is not evidenced in the excerpts.
Main entry points: workflow.py LangGraph workflow · tools.py Agent tools · code_generator.py Manim generator · page.tsx Web page
Components 24
Web experience
- Web page
Frontend/src/app/page.tsx - Hero section
Frontend/src/components/Hero.tsx - Video explanation
Frontend/src/components/VideoExplanation.tsx
API and orchestration
- FastAPI endpoint
backend/api/main.py - LangGraph workflow
backend/graph/workflow.py - Orchestrator
backend/agents/orchestrator.py - Agent tools
backend/agents/tools.py - Gemini client
backend/config.py
Generation and rendering
- Animation planner
backend/agents/planner_agent.py - Manim generator
backend/agents/code_generator.py - Code reviewer
backend/agents/code_reviewer.py - Manim executor
backend/agents/execution_agent.py - Matplotlib generator
backend/agents/matplotlib_agent.py - Matplotlib executor
backend/agents/matplotlib_execution_agent.py - Code extractor
backend/utils/code_extractor.py
Media and knowledge
- Transcript agent
backend/agents/transcript_agent.py - Audio agent
backend/agents/audio_agent.py - Speech generation
backend/gen_audio.py - Video merger
backend/utils/video_merge.py - Animation retrieval
backend/rag/retriever.py - Vector collection
backend/rag/vector_store.py - Persistent memory
backend/memory/persistent_memory.py
Other components
- User
- Gemini service
Connections 27
- User → FastAPI endpoint: submits prompt
README.md - FastAPI endpoint → LangGraph workflow: invokes graph
backend/api/main.py - LangGraph workflow → Orchestrator: decides route
backend/graph/workflow.py - Orchestrator → Gemini client: asks model
backend/agents/orchestrator.py - Gemini client → Gemini service: generates content
backend/config.py - LangGraph workflow → Animation retrieval: checks and stores
backend/graph/workflow.py - Animation retrieval → Vector collection: queries and adds
backend/rag/retriever.py - LangGraph workflow → Manim generator: generates code
backend/graph/workflow.py - Manim generator → Persistent memory: reads similar cases
backend/agents/code_generator.py - Manim generator → Code extractor: extracts code
backend/agents/code_generator.py - LangGraph workflow → Manim executor: executes code
backend/graph/workflow.py - Manim executor → Code reviewer: uses for review
backend/agents/execution_agent.py - Code reviewer → Code extractor: extracts revised code
backend/agents/code_reviewer.py - LangGraph workflow → Matplotlib generator: generates plot code
backend/graph/workflow.py - LangGraph workflow → Matplotlib executor: renders plot video
backend/graph/workflow.py - LangGraph workflow → Transcript agent: generates transcript
backend/graph/workflow.py - LangGraph workflow → Audio agent: generates audio
backend/graph/workflow.py - Audio agent → Speech generation: creates speech
backend/agents/audio_agent.py - LangGraph workflow → Video merger: merges media
backend/graph/workflow.py - Agent tools → Animation planner: creates plan
backend/agents/tools.py - Agent tools → Manim generator: generates code
backend/agents/tools.py - Agent tools → Code reviewer: reviews code
backend/agents/tools.py - Agent tools → Manim executor: executes code
backend/agents/tools.py - FastAPI endpoint → User: returns media links
backend/api/main.py - User → Web page: uses interface
- Web page → Hero section: presents section
- Web page → Video explanation: presents section