Kimodo adds local AI humanoid animation generation to an existing Unity project. It supports prompt-driven motion, pose and end-effector constraints, analysis, baking, retargeting, Animator content, Timeline authoring, and runtime motion playback.
- Runs from a project-owned local runtime.
- Supports Windows, macOS, and Linux; CUDA is the primary acceleration path and CPU fallback is available.
- Keeps animation generation and assets inside the Unity project workflow.
- Unity 2022.3 or newer
- An existing Unity project
- A character with a valid Humanoid Animator for humanoid workflows
- At least 8 GB memory and sufficient disk space for the selected models
In Unity Package Manager, choose Add package from git URL and enter:
https://github.com/OneYoungMean/KimodoUnityBridge.git
For a manifest dependency, use the same Git URL:
"com.unity.kimodo_unity_motion_tools": "https://github.com/OneYoungMean/KimodoUnityBridge.git"- Import the package's Light Sample from Unity Package Manager, or open the FullDemo.
- Open its Timeline and select a Kimodo clip bound to a character.
- Enter a motion prompt and choose Generate & Bake.
- Wait for the project-local runtime and model to become ready, then play the Timeline.
Runtime diagnostics are written to NvlabKimodoQuickServer~/log/setup.log and NvlabKimodoQuickServer~/log/bridge_server.log in the Unity project.
Read SKILL.md as the task entry point and reusable animation loop; shared command, evidence, recognition, and comparison rules are in tools/common.md. kimodo_install_server and kimodo_generate_animation are asynchronous and return a request_id; poll either with kimodo_get_generation. Command definitions are kept in Command/help.json.
The temporary analysis.video and analysis.picture commands return SMPL-X pose arrays through kimodo_get_generation. QuickServer bundles the Mixamo LLM Mocap pipeline and its 3.54 MB SMPLX_NEUTRAL_LITE_V437.npz asset for pose-only analysis; the full SMPL-X model is not required for these commands. Override the bundled source with KIMODO_MOCAP_ROOT, or set KIMODO_MOCAP_PYTHON to the GVHMR Python executable. Picture analysis estimates one pose from a short repeated still-image sequence.
Repository maintenance rules and development notes are in development/. The root AGENTS.md is only the repository-tool entry point and links to the detailed maintenance rules.
The documentation ownership is:
README.md/README.zh-CN.md: user-facing package documentation.SKILL.md: installation and task entry point.tools/*.md: cooperating capability tools and their task procedures.Command/help.json: command definitions and parameter schema.development/: developer maintenance, compatibility, plans, and handoff notes.