Unitree Hermes Colab

Unitree Hermes Colab

Goal

Create or review a Colab notebook that makes Hermes Agent useful for Unitree work without pretending Colab is a safe robot-control host. The notebook should install or check Hermes, clone selected Unitree repositories, generate read-only artifacts, and show clear pass/fail review gates.

Hard Boundaries

• Do not execute robot-control commands from Colab.
• Do not publish DDS, ROS, motor, sport-mode, or low-level commands.
• Do not SSH, SCP, tunnel, or scan Unitree robot LAN addresses such as 192.168.123.0/24.
• Do not claim physical hardware validation unless the user provided external evidence.
• Put risky local-host commands in quoted runbooks for a human to review and run on the correct machine.
• Hermes one-shot execution must be opt-in. It is acceptable to install Hermes and prepare prompts by default.

Build Workflow

1. Keep one configuration block near the top of the notebook or runner: INSTALL_HERMES, RUN_HERMES_AGENT, CLONE_UNITREE_REPOS, PROVIDER, MODEL, and output directory.
2. Record runtime versions: Python, platform, GPU/CUDA when present, Hermes CLI status, and cloned repo commit SHAs.
3. Clone only important Unitree repositories by default: unitreerobotics/xr_teleoperate, unitree_sdk2_python, and unitree_mujoco.
4. Write a local AGENTS.md safety file before any optional Hermes run.
5. Generate these use cases at minimum: simulation runbook, teleoperation preflight checklist, log triage, contribution scouting, and IK evidence review.
6. Render user-facing outputs as a report: cards, repository map, flow visualization, review gates, references, and saved artifacts.
7. Save unitree-hermes-report.md, unitree-hermes-review.json, AGENTS.md, and a flow visualization.

Output Standards

• Do not leak meta-instructions like "Notebook organization" into the report. Use user-facing labels such as "Review gates", "Runtime", "Use cases", and "References".
• Keep references limited to important sources: Hermes Agent, Hermes docs, Unitree repositories, and Codex skills/subagents when the artifact includes a Codex skill.
• Include a critical usefulness score. Good default framing: high value for setup review and log triage, low value for live robot control.
• Mark skipped Hermes execution clearly when no provider key is present or RUN_HERMES_AGENT is false.

Validation

Run the project checks when working in this repo:

python3 -m py_compile src/unitree_colab_ik/hermes_lab.py src/unitree_colab_ik/hermes_cli.py notebooks/run_unitree_hermes_agent_lab.py
python3 -m json.tool notebooks/unitree_hermes_agent_lab.ipynb >/dev/null
python3 -m compileall -q src tests
python3 skill/unitree-hermes-colab/scripts/check_lab_artifacts.py 

Run tests if pytest is available:

python3 -m pytest tests/test_hermes_lab.py

Subagent Review

Use Codex subagents only when the user explicitly asks for parallel/subagent review. Keep them read-heavy. Good split:

• safety reviewer: checks no robot-control execution path exists
• notebook reviewer: checks clean-runtime reproducibility and visible outputs
• contribution reviewer: checks whether the Unitree/Hermes use cases are genuinely useful and small enough to publish

The main agent should wait for summaries and integrate findings. Avoid parallel write-heavy edits unless the user explicitly requests that.