Skip to main content
Glama

AnimAI

Production-safe 3D & motion components your AI agent can install.

AI agents are great at UI — and notoriously bad at WebGL. Ask one for a Three.js hero and you'll usually get VRAM leaks, SSR crashes, and hydration bugs. AnimAI fixes that with a registry of pre-vetted React Three Fiber & GSAP components that are certified leak-free, SSR-safe, and performance-budgeted — then injected into your Next.js app with AST-safe edits (never regex) by a CLI or an MCP server your agent calls directly.

npx animai add hero-orbital-rig

Why vetted matters

Every component ships with a machine-generated vetting report, produced by the harness in scripts/vet.mjs and enforced in CI:

Check

Guarantee

Dispose audit

a useEffect cleanup disposes every geometry/material/texture — no VRAM leaks

SSR gate

WebGL is loaded via next/dynamic { ssr: false } — no server crashes

GSAP rule

animations use useGSAP() — timelines revert cleanly in Strict Mode

Canvas sizing

<Canvas> always gets an explicitly sized container

Related MCP server: threejs-devtools-mcp

Use it from your AI agent (MCP)

Add one line to your agent's MCP config (Cursor, Claude Code, Windsurf):

{
  "mcpServers": {
    "animai": { "command": "npx", "args": ["-y", "animai", "mcp"] }
  }
}

Your agent gets two flat, deterministic tools:

  • search_motion_library — natural-language search over the registry

  • fetch_motion_component — exact vetted source + dependencies + integration steps

Use it from the CLI

npx animai search "dark 3d hero"        # find components
npx animai add hero-orbital-rig          # write files + AST-patch your route
npx animai add hero-orbital-rig --dry-run
npx animai add hero-orbital-rig --target main
npx animai doctor hero-orbital-rig       # check peer-dependency versions
npx animai update hero-orbital-rig       # re-fetch latest (guards your local edits)
npx animai login <license-key>           # unlock Pro components

add writes the component + SSR-safe loader into app/components/ and injects the JSX into your route using @ast-grep/napi Find & Patch — imports and nodes are inserted through the AST, so your source is never corrupted by string replacement.

Free & Pro

The CLI, MCP server, and a growing set of components are free (MIT). Pro components are delivered through a licensed registry — the public npm package and CDN never contain Pro source. See docs/registry.md.

Repository layout

Path

What it is

src/

CLI + MCP server + registry client (the animai npm package)

registry/

Component source of truth (manifest.json + code per component)

scripts/

Registry/CDN build steps + the vetting harness

web/

animai.dev — browse, docs, and a live MCP playground

worker/

Cloudflare Worker serving the licensed registry (Polar)

docs/

vetting and registry architecture

examples/next-demo

Minimal Next.js target app for trying add locally

Develop

npm install
npm run build        # build registry data + compile TypeScript
npm run vet          # run the vetting harness, write reports
npm run vet:check    # CI gate — non-zero exit on any critical failure
npm run demo:dry-run # preview an AST injection against examples/next-demo
npm run mcp          # start the MCP server on stdio

License

MIT for the tooling and free components. Pro components are licensed per the terms at animai.dev.

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    B
    maintenance
    Enables AI coding agents to search across 340+ React UI registries, inspect component code and quality scores, compare options, detect a project's stack, and generate or execute safe transactional install plans. It provides read and write safeguards with dry-run planning and rollback.
    1
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to inspect and modify live Three.js scenes in real time through 59 tools covering objects, materials, shaders, textures, animations, performance monitoring, memory diagnostics, and code generation. Works with vanilla Three.js, React Three Fiber, and any framework without changing your project, using an injected browser bridge and in-page devtools overlay.
    1,188 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to inspect a running Three.js scene in the browser and try out live edits to objects, materials, shaders, lights, camera and animation without touching project files. Every change is recorded and can be exported as ready-to-paste vanilla Three.js or React Three Fiber code, alongside performance audits and frame capture.
    1,188 npm
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables AI agents to inspect and edit Three.js scenes, materials, shaders, lights, animations, and performance in real time, preview changes live in the browser, capture frames, and turn approved changes into code. It supports vanilla Three.js and React Three Fiber across WebGL/WebGPU without modifying the project.
    1,188 npm
    MIT