geniesim_cli

June 29, 2026 · View on GitHub

Lightweight command-line front-end for the Genie Sim stack. Published as the geniesim_cli distribution; sole owner of the geniesim console script.

License: Mozilla Public License Version 2.0 Agent doc: AGENTS.md · Deep-dive: ../../.agent/geniesim_cli.md

📦 Install

pip install -e source/geniesim_cli/
geniesim version

The CLI is a standalone PEP 517 / PEP 621 wheel with no heavy runtime deps (no USD, no Isaac Sim, no MuJoCo at import time), so it runs even on a control node where the rest of the SDK isn't installed.

🛠️ Command surface

CommandPurpose
geniesim versionPrint versions of all distributions + Python
geniesim statusPer-distribution health probe
geniesim doctorDiagnose & repair (status + rosdep + env)
geniesim bootstrapInstall every peer distribution in topological order
geniesim envShow GENIESIM_* env vars
geniesim completion bash|zshGenerate shell completion
geniesim docker {build,up,down,into,logs}Manage the Genie Sim container
geniesim docker5.1 … / docker6.0 … / docker4.5 …Per–Isaac-Sim variants
geniesim ros build {dev,release,cleanup}colcon build the ROS 2 workspace
geniesim ros doctorRepair rosdep
geniesim tool {deps-dag,ros-dag,docs} [--fix]Repo-maintenance audits (DAG + doc-coverage)
geniesim deploy [MODULE]Build pure-Python wheel(s) into ./deploy/
geniesim benchmark {run,batch,list,…}Drive geniesim_benchmark tasks
geniesim teleop runLaunch the teleop loop

Run geniesim -h for the full list.

🚀 Fresh-machine setup

git clone https://github.com/AgibotTech/genie_sim.git
cd genie_sim
pip install -e source/geniesim_cli/   # 1. CLI first (no heavy deps)
geniesim bootstrap                    # 2. installs siblings + assets
geniesim status                       # 3. all-green check
geniesim doctor                       # 4. repair if not

See AGENTS.md § 0 — Fresh-machine setup for the install-order contract.

🏗️ Architecture (in one line)

cli.py is a single-file dispatcher: every subcommand lives in commands/<name>.py and is loaded lazily so the import cost stays near zero. Heavy deps (USD, MuJoCo, anything geniesim.*) must NEVER be imported at module top-level — see AGENTS.md §6.

🔗 Pointers