Self-hosted MMCP server for Kimodo motion generation.
Run Kimodo on your own GPU and expose it over HTTP so any MMCP client can generate animation. The reference client is Proscenium for Blender — text prompts, paths, and pose constraints on your armature.
This repo is for developers who are comfortable with Python environments, CUDA, and self-hosting ML services. The install assumes you can debug pip, virtualenvs, CUDA drivers, and Hugging Face authentication on your own. See Installation and MotionCorrection for what that involves.
If you are an animator or artist and want Kimodo in Blender without that setup, use the hosted product at animatica.ai — same model family, no local server install. Point the Proscenium plugin at your Animatica endpoint and generate from there.
Alpha — APIs and packaging may change. Tracks
motionmcp0.1.x and Kimodo 1.x.
- MMCP-native — implements
motionmcp.Backbone; capabilities,/generate, glTF responses - Kimodo SOMA models — loads Kimodo checkpoints; maps MMCP requests to Kimodo inference
- Constraint-aware — root paths, effector targets, pose keyframes (see MMCP concepts)
- Simple CLI —
motionmcp-kimodo --port 8000for local or LAN use - Embeddable — mount
KimodoBackbonein your own FastAPI / ASGI app (Development)
| Python | 3.10+ |
| GPU | NVIDIA GPU strongly recommended (CUDA-capable PyTorch) |
| Build tools | CMake + C++ compiler — Kimodo builds MotionCorrection during install (guide) |
| Git | Required for pip install (Kimodo is not on PyPI) |
Full setup (Blender addon, troubleshooting): Installation.
pip install "motionmcp-kimodo @ git+https://github.com/animatica-ai/motionmcp-kimodo.git"
motionmcp-kimodo --port 8000Install Proscenium, set Server to http://localhost:8000, and connect from the N-panel.
Install can take 30+ minutes on first run (PyTorch, Kimodo, MotionCorrection compile). Use pip install -v ... to see progress.
| Guide | Description |
|---|---|
| Installation | End-to-end setup with Proscenium |
| MotionCorrection | C++ build step (common install blocker) |
| Usage | CLI, ports, models, environment variables |
| Development | Architecture and programmatic use |
| Docs index | All guides and external links |
| Project | Role |
|---|---|
| MMCP | Motion Model Communication Protocol |
| motionmcp | Python SDK (Backbone, server helpers) |
| Kimodo | Motion diffusion model (dependency) |
| Proscenium | Official Blender client |
| Implementations | All official servers & clients |
Contributions are welcome.
- Check open issues or open one to discuss larger changes.
- Clone, install dev deps, and run tests — see Development.
- Open a pull request with a clear description and test plan.
Bug reports for install failures: include OS, Python version, and the full pip install -v log (especially the MotionCorrection build).
Animatica AI Discord — questions, install help, Proscenium, and MMCP/Kimodo discussion.
Apache License 2.0. Kimodo model weights and third-party deps have separate licenses — see Kimodo and Hugging Face model cards.