How lewdineer/kimodo_blender_bridge works
Kimodo Blender Bridge is a Blender addon for generating AI human motion and applying it in a scene. The main workflow is: configure and start the Kimodo bridge, submit a single prompt or timeline segments, generate motion in a persistent external process, then import the result into Blender. Users can also supply spatial motion constraints and retarget generated motion onto their own rigs, bake it, and reuse bone-mapping presets. The README documents these product flows; some links between addon modules are not visible in the sampled excerpts, so those are omitted or marked unverified.
Main entry points: bridge_server.py Bridge server · retarget.py Bone retargeting · panels.py Addon panels · operators.py Addon operators
Components 15
Blender UI
- Addon panels
panels.py - Scene settings
properties.py - Addon operators
operators.py - Mapping and history lists
ui_list.py
Generation Bridge
- Kimodo installer
setup_operator.py - Subprocess client
subprocess_client.py - Bridge server
bridge_server.py
Motion Inputs
- Timeline segments
operators.py - Spatial constraints
constraints.py - Generated motion file
Retargeting
- Bone retargeting
retarget.py - Mapping presets
retarget.py
Other components
- Blender user
- Kimodo model
- Blender scene armature
Connections 21
- Blender user → Addon panels: uses
README.md - Addon panels → Addon operators: invokes
README.md - Addon panels → Scene settings: configures
README.md - Addon operators → Scene settings: reads settings
operators.py - Blender user → Kimodo installer: starts install
README.md - Blender user → Subprocess client: starts bridge
README.md - Subprocess client → Bridge server: sends JSON
README.md - Bridge server → Kimodo model: requests generation
bridge_server.py - Blender user → Timeline segments: edits segments
README.md - Timeline segments → Bridge server: submits prompts
README.md - Blender user → Spatial constraints: sets waypoints
README.md - Spatial constraints → Bridge server: supplies constraints
- Bridge server → Generated motion file: writes motion
bridge_server.py - Addon operators → Generated motion file: imports motion
README.md - Generated motion file → Blender scene armature: creates armature
README.md - Blender user → Bone retargeting: maps rig
README.md - Bone retargeting → Blender scene armature: adds constraints
README.md - Blender user → Mapping presets: saves mappings
README.md - Mapping presets → Bone retargeting: restores mappings
README.md - Bone retargeting → Blender scene armature: bakes keyframes
README.md - Mapping and history lists → Bone retargeting: displays mappings
ui_list.py