Teleop Project (x86_64 PC)
venv/teleop 用来在 laptop / desktop 上跑 Pico / XR body tracking 和 realtime retarget 检查。录制和回放 motion clip 请切到 root project,用 any4hdmi-backed scripts。
Setup
uv --project venv/teleop sync
安装 XRoboToolkit PC Service
从下面的 release 页面下载 .deb:
https://github.com/XR-Robotics/XRoboToolkit-PC-Service/releases
sudo apt install -y ./XRoboToolkit_PC_Service_*.deb
安装后,从桌面或应用列表启动 XRoboToolkit / XRobot。
Clone Pico SDK 仓库
mkdir -p external
git clone https://github.com/YanjieZe/XRoboToolkit-PC-Service-Pybind.git \
external/XRoboToolkit-PC-Service-Pybind
git clone https://github.com/XR-Robotics/XRoboToolkit-PC-Service.git \
external/XRoboToolkit-PC-Service
Build 并安装 xrobotoolkit_sdk
bash scripts/setup/setup_xrobot_pybind.sh
这个脚本默认要求上面两个仓库已经位于 external/ 下。
打开 Pico streaming
- 戴好腿部 trackers。
- 完成 whole-body tracking 校准。
- 打开
XRoboToolkit,连接到当前机器。 - 打开 whole-body streaming。
Verify Installation
先启动 live retarget publisher:
uv --project venv/teleop run sim2real/teleop/pico_retarget_pub.py
打开 publisher 打印出来的 mjviser URL。如果 viewer 里能看到实时更新的 G1 retarget 动作,teleop 环境就通了。
live publisher 跑起来之后,如果要录制并回放 qpos clip,切到 root project 环境:
uv run scripts/record_motion.py
uv run scripts/view_motion.py --motion g1_motion_YYYYMMDD_HHMMSS/motions/motion.npz