AniMathIO revolutionizes the creation of mathematical videos, tailored for educators, students, and professionals seeking to bring complex concepts to life

They are core part of the AniMathIO software! Check them out!

• mafs
• nextron

• Special thanks for these projects
• Table of Contents
• OS Support
• Installation
• AI Agent Integration (MCP)
• Development build
  • Canvas build fix
    • NOTE: If you want proper development you will need to follow the steps regarding the canvas build and install all the necessary dependencies
  • Running the app
• Contributing
• Star History

We are supporting the following operating systems: Windows, Linux (via AppImage, Snap, Flatpak, DEB packages, and AUR).

NOTE: macOS is currently unsupported. Due to the lack of available resources, the latest version of AniMathIO that supports macOS is the legacy 1.3.0 version.

1. Download the latest AniMathIO.Setup.X.X.X.exe installer from the release page
2. Run the installer and follow the installation wizard
3. Launch AniMathIO from the Start Menu or desktop shortcut

Alternatively, you can download win-unpacked.zip for a portable version (no installation required).

AniMathIO is available in multiple formats for Linux distributions:

1. Download AniMathIO-X.X.X.AppImage from the release page

2. Make it executable:

   chmod +x AniMathIO-X.X.X.AppImage

3. Run it:

   ./AniMathIO-X.X.X.AppImage

Install via snap:

sudo snap install animathio

Or download the .snap file from the release page and install it:

sudo snap install --dangerous animathio_X.X.X_amd64.snap

Note: Flatpak support is experimental and may have limitations.

1. Download AniMathIO-X.X.X-x86_64.flatpak from the release page

2. Install it:

   flatpak install AniMathIO-X.X.X-x86_64.flatpak

1. Download animathio_X.X.X_amd64.deb from the release page

2. Install it:

   sudo dpkg -i animathio_X.X.X_amd64.deb
   sudo apt-get install -f  # Install any missing dependencies

AniMathIO is available in the AUR as animathio-bin:

# Using yay (recommended)
yay -S animathio-bin

# Or using paru
paru -S animathio-bin

# Or manually with makepkg
git clone https://aur.archlinux.org/animathio-bin.git
cd animathio-bin
makepkg -si

AUR Package: animathio-bin

Download linux-unpacked.tar.gz from the release page, extract it, and run the executable directly.

⚠️ macOS is currently unsupported. The latest version of AniMathIO that supports macOS is the legacy 1.3.0 version, available on the release page.

Alternative Download: You can also download binaries from our website: https://animathio.com/

AniMathIO includes a built-in Model Context Protocol server, so AI agents such as Claude can drive the editor while you watch changes appear on the canvas.

The server runs inside the Electron main process, so AniMathIO must be running with a project open. It is disabled by default — enable it under Settings, which shows the endpoint and an auth token.

• Endpoint: http://127.0.0.1:<port>/mcp (default port 4517, loopback only)
• Auth: bearer token, shown in Settings
• Transport: HTTP MCP, not stdio

import_manim_scene is the highest-leverage one: it builds an entire scene in a single call.

add_media takes a required path on the machine running AniMathIO and returns the created element IDs; a video creates both video and audio elements. It selects the matching resource panel and waits for the media to decode. Unsupported file types, missing files, and decoding failures report an error.

export_video takes a required absolute path ending in .mp4 or .webm and an optional format that must match the extension (otherwise the extension determines the format). The parent directory must exist; an existing destination is overwritten. Export records in real time: a 30-second project takes at least 30 seconds, plus conversion and writing. MP4 conversion fetches the FFmpeg core if needed. Allow a long client timeout, keep the project open, and avoid editing during export. The tool returns after the file is written.

Security: a connected agent can read local media, modify the open project, and write files. Keep the token private, and enable the server only while you are using it.

node scripts/mcp-smoke.mjs --token <token>                  # list tools
node scripts/mcp-smoke.mjs --token <token> --tool get_project_state

Clone project

git clone

Install dependencies

cd AniMathIO
npm install

Temporary fix for canvas build errors

# if canvas errors occur regardig node mismatch run the following line
npm rebuild canvas --update-binary

• All platforms
• Windows

# development mode
npm run dev

# production build
npm run build

We welcome contributions to AniMathIO. Please read our contributing guidelines to get started.