gitwtfhub

wtf is hoic-baseline?

cybercal/hoic-baseline — explained in plain English

Analysis updated 2026-05-18

39PythonAudience · researcherComplexity · 4/5Setup · moderate

TL;DR

A research baseline for testing how simulated humanoid robots push carts, move boxes, ride skateboards, and steer wheelchairs using two control methods.

Mindmap

mindmap
  root((HOIC baseline))
    What it does
      Humanoid object interaction
      Two control methods
      Runs in MuJoCo
    Tech stack
      Python
      MuJoCo
      ONNX
    Use cases
      Test HAIC policies
      Compare vision based control
      Record simulation videos
    Audience
      Robotics researchers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Why would anyone build with this?

REASON 1

Run pretrained HAIC or VAIC policies in MuJoCo simulation to measure a humanoid robot's success rate on object interaction tasks.

REASON 2

Compare a reference-motion approach against a vision-based approach for controlling humanoid object interaction.

REASON 3

Record simulation videos and tune physics timestep and control frequency for these object interaction tasks.

REASON 4

Use the provided training code links to train a custom policy on the same task set.

What's in the stack?

PythonMuJoCoONNXConda

How it stacks up

cybercal/hoic-baselineaa2448208027-code/localaihotswapamapvoice/pilottts
Stars393939
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity4/53/54/5
Audienceresearcherdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you spin it up?

Difficulty · moderate Time to first run · 30min

Requires a Python 3.8 conda environment with mujoco and onnxruntime, VAIC policy deployment is not yet released.

Wtf does this do

This repository provides two baseline methods for testing how humanoid robots can interact with physical objects: pushing and pulling carts, moving boxes across stairs and slopes, riding a skateboard, and maneuvering a wheelchair. It accompanies research papers from 2026 and is designed so that other researchers can run these simulations and measure success rates on the provided tasks. The two methods are called HAIC and VAIC. HAIC works by giving the robot reference motion clips (recordings of how a robot-object pair should move) along with a model that tracks the physics of the interaction. The robot uses those references to figure out how to control itself. VAIC takes a different approach: it is reference-free and instead uses a depth image from the robot's own perspective to adapt to objects it has not seen before. The simulation runs inside MuJoCo, a widely used physics engine for robotics research. Setup requires Python 3.8 with a few packages (mujoco, onnxruntime, opencv, and a couple of image tools). The trained policies are stored as ONNX files, which are a portable format for sharing neural network models, so you do not need to retrain anything to run the demos. You simply activate a conda environment, pick a task from the list (skateboard, box_plane, push_cart, push_wheelchair, and several others), and run the corresponding script. The repository also includes options for recording videos of the simulation runs and for adjusting timing parameters such as physics timestep and control frequency. A helper script checks that every task has its policy file, motion file, and robot description in place before you try to run it. This is a research baseline, meaning it is meant as a starting point for building on top of these methods, not a finished product. The VAIC policy deployment is noted as not yet released. If you want to train your own policy using the same framework, the authors link to separate repositories for HAIC and VAIC training code.

Yoink these prompts

Prompt 1
Help me set up the conda environment and run the skateboard task from this HOIC baseline repo.
Prompt 2
Explain the difference between the HAIC and VAIC methods in this repository and when each would be used.
Prompt 3
Show me how to use the check_assets option to confirm every task has its policy, motion, and robot files before running.
Prompt 4
Walk me through recording a video of the box_slopestair task using this repo's scripts.

Frequently asked questions

wtf is hoic-baseline?

A research baseline for testing how simulated humanoid robots push carts, move boxes, ride skateboards, and steer wheelchairs using two control methods.

What language is hoic-baseline written in?

Mainly Python. The stack also includes Python, MuJoCo, ONNX.

How hard is hoic-baseline to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is hoic-baseline for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.