kimodo-motion-diffusion
kimodo-motion-diffusion — an installable skill for AI agents.
By reason-machines · 1,248 installs
npx skills add reason-machines/trending-skills --skill kimodo-motion-diffusion
Source repository · Upstream listing
Kimodo Motion Diffusion
Skill by [ara.so](https://ara.so) — Daily 2026 Skills collection.
Kimodo is a kinematic motion diffusion model trained on 700 hours of commercially friendly optical mocap data. It generates high quality 3D human and humanoid robot motions controlled through text prompts and kinematic constraints (full body keyframes, end effector positions/rotations, 2D paths, 2D waypoints).
Installation
Requirements:
~17GB VRAM (GPU: RTX 3090/4090, A100 recommended)
Linux (Windows supported via Docker)
Models download automatically on first use from Hugging Face
Available Models
Model Skeleton Dataset Use Case
Kimodo SOMA RP v1 SOMA (human) Bones Rigplay 1 (700h) General human motion
Kimodo G1 RP v1 Unitree G1 (robot) Bones Rigplay 1 (700h) Humanoid robot motion
Kimodo SOMA SEED v1 SOMA BONES SEED (288h) Benchmarking
Kimodo G1 SEED v1 Unitree G1 BONES SEED (288h) Benchmarking
Kimodo SMPLX RP v1 SMPL X Bones Rigplay 1 (700h) Retargeting/AMASS export
CLI: kimodo gen
Basic Text to Motion
Output Formats
Multi Prompt Sequences
Constraint Based Generation
Interactive Demo
The demo provides:
Timeline editor for text prompts and constraints
Full body keyframe constraints
2D root path/waypoint editor
End effector position/rotation control
Real time 3D visualization with skeleton and skinned mesh
Export of constraints as JSON and motions as NPZ
Low Level Python API
Basic Model Inference
Advanced API with Guidance and Constraints
Working with Constraints Programmatically
Loading and Using Saved Constraints
Saving and Loading Generated Motions
Robotics Integration
MuJoCo Visualization (G1 Robot)
ProtoMotions Integration
GMR Retargeting (SMPL X to Other Robots)
NPZ Output Format Reference
Key Shape Description
posed joints [T, J, 3] Global joint positions in meters
global rot mats [T, J, 3, 3] Global joint rotation matrices
local rot mats [T, J, 3, 3] Parent relative joint rotation matrices
foot contacts [T, 4] Contact labels: [L heel, L toe, R heel, R toe]
smooth root pos [T, 3] Smoothed root trajectory from model
root positions [T, 3] Actual root joint (pelvis) trajectory
global root heading [T, 2] Heading direction (2D unit vector)
T = number of frames (30fps), J = number of joints (skeleton dependent)
Scripts Reference
Common Patterns
Batch Generation Pipeline
Comparing Model Variants
Troubleshooting
Out of VRAM (~17GB required):
Model download issues:
Motion quality issues:
Be specific in prompts: "a person walks forward at a moderate pace" "walking"
For complex motions, use the interactive demo to add keyframe constraints
Increase diffusion steps (default ~20 30, try 50 for higher quality)
Generate multiple samples ( num samples 5 ) and select the best
Avoid prompts with extremely fast or physically impossible actions
The model operates at 30fps; very short durations (<1s) may yield poor results
Foot skating artifacts:
Interactive demo not loading: