Animo: Animated Videos from Text

Create wonderful animations from text using AI in Cursor, VS Code, Windsurf, or any AI-powered editor.

Animo integrates seamlessly with your AI coding assistant to help you create professional mathematical animations using Manim. Simply describe your idea, and let AI agents iteratively improve your animations with intelligent feedback.

✨ Features

• 🤖 AI-Powered CLI: Command-line tool that works with any AI agent (Cursor, Claude, GitHub Copilot, etc.)
• 🔄 Iterative Improvement: Get frame-by-frame AI feedback to perfect your animations
• 📱 Integrated Video Panel: Preview your animations directly in the editor
• 🎯 Smart Rendering: Local Manim rendering with optional AI analysis
• 📚 Documentation Search: AI-powered search through Manim documentation
• 🚀 Zero Setup: Automatic installation of CLI tools and configuration

🚀 Quick Start

1. Install the Extension

   • Open your AI-powered editor (Cursor, VS Code, Windsurf, etc.)
   • Go to Extensions (Ctrl+Shift+X / Cmd+Shift+X)
   • Search for "Animo"
   • Click Install

2. Sign In to Animo

   • Click the Animo icon in the sidebar
   • Sign in with your Animo.video account
   • Get your API key from Animo.video/account/developer
   • The extension automatically sets up the Animo CLI in ~/.agi/animo-core.py

3. Create Your First Animation with AI

   • Open your AI chat (Cursor Composer, GitHub Copilot Chat, etc.)
   • Describe your animation idea: "Create a circle that transforms into a square"
   • Your AI will use the Animo CLI to render and improve your animation
   • Preview the video directly in your editor!

🎯 How It Works with AI

1. Describe Your Idea to AI

User: "Create a blue circle that moves from left to right, then transforms into a red square"

2. AI Generates and Iterates

Your AI assistant (Cursor, Copilot, Claude, etc.) uses the Animo CLI:

# AI renders and analyzes your scene
python3 ~/.agi/animo-core.py --render-and-describe \
  --render-file="scene.py" --render-scene="MyScene"

The AI receives intelligent feedback:

{
  "issues": [
    {
      "second": 2,
      "error": "Text overlaps with circle",
      "possible_edit": "Use .next_to(circle, UP, buff=0.5)"
    }
  ]
}

3. AI Applies Fixes Automatically

Based on the feedback, your AI iteratively improves the code until perfect:

from manim import *

class MyScene(Scene):
    def construct(self):
        circle = Circle(color=BLUE)
        circle.shift(LEFT * 3)
        self.play(Create(circle))
        self.play(circle.animate.shift(RIGHT * 6))
        square = Square(color=RED)
        square.move_to(circle.get_center())
        self.play(Transform(circle, square))

4. Preview & Share

• Video automatically displays in editor sidebar
• Export to Animo.video for sharing
• All render history saved locally

🛠️ Requirements

• Python 3.8+
• Manim Community Edition (automatically detected and guided installation)
• AI-Powered Editor (Cursor, VS Code with Copilot, Windsurf, or any editor with AI chat)

🤖 Animo CLI Tool

The extension automatically installs a powerful CLI tool that AI agents use to create animations:

Available Commands

Search Documentation

python3 ~/.agi/animo-core.py --search-docs="Circle"

AI can search Manim documentation for help with syntax and examples.

Render Scene

python3 ~/.agi/animo-core.py --render-file="scene.py" --render-scene="MyScene"

Quick local rendering for debugging (0 credits).

Render and Get AI Feedback

python3 ~/.agi/animo-core.py --render-and-describe --render-file="scene.py" --render-scene="MyScene"

Renders locally, then uploads for frame-by-frame AI analysis (~5 credits).

How AI Uses It

Your AI assistant automatically:

1. Creates Manim code based on your description
2. Renders and analyzes with --render-and-describe
3. Reads the AI feedback (overlapping text, poor timing, etc.)
4. Applies suggested fixes to the code
5. Repeats until perfect

Supported AI Assistants:

• 🔵 Cursor (Composer, Chat)
• 💜 GitHub Copilot (Chat, Workspace)
• 🌊 Windsurf
• 🤖 Claude Code
• 🔶 Any AI with file access

📋 Commands

Access these commands through the Command Palette (Ctrl+Shift+P / Cmd+Shift+P):

• Animo: Sign in to Animo - Authenticate with Animo.video
• Animo: Check Dependencies - Verify Manim and dependencies installation

🎨 Interface Overview

Sidebar Panel

• Video Preview: Real-time preview of your animations
• Scene Code Editor: Python syntax highlighting with live editing
• Render History: Browse and reload previous animations
• Export Controls: Share and export functionality

Action Buttons

• Export: Save your animation to Animo.video (private)
• Share: Create public shareable links
• Copy: Copy share URLs with persistent modal

🔧 Troubleshooting

Common Issues

Extension not loading?

• Ensure you're using a supported editor version
• Try reloading the window (Ctrl+R / Cmd+R)

Manim not found?

• Use the "Check Dependencies" command
• Follow the guided installation process
• Ensure Python and pip are installed

Authentication issues?

• Verify your API key in settings
• Sign out and back in through the sidebar
• Check your internet connection

Ready to bring your mathematical visualizations to life? Get started with Animo today!