How amazon-far/holosoma works
Holosoma combines humanoid RL training, policy inference/deployment, and motion retargeting. The primary workflow configures a robot and task, trains a policy in a supported simulator, then evaluates or deploys it through the shared inference pipeline. Retargeting is a distinct motion-data-to-robot-motion branch that can support whole-body tracking. The graph preserves documented algorithm, simulator, and robot capabilities; unsampled subsystem links are limited to README-supported relationships or omitted.
Main entry points: base_task.py Task environments · mujoco.py MuJoCo backend · train_agent.py Training entry · interaction_mesh_retargeter.py Motion retargeter
Components 24
Training and tasks
- Training entry
src/holosoma/holosoma/train_agent.py - Task environments
src/holosoma/holosoma/envs/base_task/base_task.py - Locomotion task
src/holosoma/holosoma/envs/locomotion/locomotion_manager.py - Whole-body task
src/holosoma/holosoma/envs/wbt/wbt_manager.py - Task managers
src/holosoma/holosoma/managers - PPO and FastSAC
src/holosoma/holosoma/agents
Simulation
- Scene configuration
src/holosoma/holosoma/config_types/scene.py - Simulator configuration
src/holosoma/holosoma/config_types/simulator.py - Simulator interface
src/holosoma/holosoma/simulator/base_simulator/base_simulator.py - IsaacGym backend
src/holosoma/holosoma/simulator/isaacgym/isaacgym.py - MuJoCo backend
src/holosoma/holosoma/simulator/mujoco/mujoco.py - MuJoCo scene builder
src/holosoma/holosoma/simulator/mujoco/scene_manager.py - Object registry
src/holosoma/holosoma/simulator/shared/object_registry.py
Inference and control
- Inference presets
src/holosoma_inference/holosoma_inference/config/config_values/inference.py - Policy runner
src/holosoma_inference/holosoma_inference/run_policy.py - Locomotion and WBT policies
src/holosoma_inference/holosoma_inference/policies - ROS2 policy service
src/holosoma_inference/holosoma_inference_service/holosoma_service/holosoma_service/policy_control/service_node.py - Robot control SDKs
src/holosoma_inference/holosoma_inference/sdk
Motion retargeting
- Motion retargeter
src/holosoma_retargeting/holosoma_retargeting/src/interaction_mesh_retargeter.py - Motion conversion
src/holosoma_retargeting/holosoma_retargeting/data_conversion/convert_data_format_mj.py - Retargeting evaluation
src/holosoma_retargeting/holosoma_retargeting/evaluation/eval_retargeting.py
Other components
- Engineer
- Simulated or real robot
- Human motion data
Connections 27
- Engineer → Training entry: configures and starts
README.md - Training entry → Task environments: trains
README.md - Task environments → Locomotion task: specializes as
src/holosoma/holosoma/envs/locomotion/locomotion_manager.py - Task environments → Whole-body task: specializes as
src/holosoma/holosoma/envs/wbt/wbt_manager.py - Locomotion task → Task environments: extends
src/holosoma/holosoma/envs/locomotion/locomotion_manager.py - Whole-body task → Task environments: uses base task
src/holosoma/holosoma/envs/wbt/wbt_manager.py - Task environments → Task managers: uses
src/holosoma/holosoma/envs/base_task/base_task.py - Training entry → PPO and FastSAC: trains with
README.md - Training entry → Simulator configuration: selects simulator
README.md - Simulator configuration → Simulator interface: configures
- Scene configuration → MuJoCo scene builder: configures scene
src/holosoma/holosoma/simulator/mujoco/scene_manager.py - Simulator interface → MuJoCo backend: implemented by
src/holosoma/holosoma/simulator/mujoco/mujoco.py - Simulator interface → IsaacGym backend: implemented by
- MuJoCo backend → MuJoCo scene builder: builds scene with
src/holosoma/holosoma/simulator/mujoco/mujoco.py - MuJoCo backend → Object registry: uses registry
src/holosoma/holosoma/simulator/mujoco/mujoco.py - Engineer → Inference presets: chooses policy settings
README.md - Inference presets → Policy runner: configures
- Policy runner → Locomotion and WBT policies: runs
- ROS2 policy service → Locomotion and WBT policies: builds and serves
src/holosoma_inference/holosoma_inference_service/holosoma_service/holosoma_service/policy_control/service_node.py - Locomotion and WBT policies → Robot control SDKs: sends commands through
- Robot control SDKs → Simulated or real robot: controls
- Human motion data → Motion retargeter: provides motion data
README.md - Motion retargeter → Motion conversion: produces robot motion
- Motion conversion → Retargeting evaluation: supports evaluation
- Motion retargeter → Retargeting evaluation: evaluated by
src/holosoma_retargeting/holosoma_retargeting/evaluation/eval_retargeting.py - Retargeting evaluation → MuJoCo backend: evaluates in
src/holosoma_retargeting/holosoma_retargeting/evaluation/eval_retargeting.py - Motion retargeter → MuJoCo backend: uses simulator
src/holosoma_retargeting/holosoma_retargeting/src/interaction_mesh_retargeter.py