Skip to main content

​
Package

uv pip install rfx-sdk
All CLI commands also work through uv run without a global install: uv run rfx deploy runs/my-policy --robot so101.

​
From source

git clone https://github.com/quantbagel/rfx.git
cd rfx
bash scripts/setup-from-source.sh
setup-from-source.sh bootstraps a Python 3.13 virtualenv via uv, installs dev dependencies, and builds the native rfx._rfx extension.

​
Verify

rfx doctor
The doctor command checks:
  • Python version and uv availability
  • torch, yaml, rfx, and the native extension import
  • Simulation backends (Genesis, MuJoCo, mock)
  • rfxJIT backends
  • Serial ports for supported robots
Use --strict to fail on missing required dependencies: 
rfx doctor --strict

​
Python version

rfx targets CPython 3.13. Genesis simulation does not yet publish wheels for 3.14 — use 3.13 if you rely on Genesis: 
uv run --python 3.13 rfx deploy runs/my-policy --robot so101

​
Supported hardware

RobotTypeInterfaceStatus
SO-1016-DOF armUSB serial (Rust driver)Ready
Unitree Go2QuadrupedEthernet (Zenoh transport)Ready
Unitree G1HumanoidEthernet (Zenoh transport)In progress
Custom robots: implement observe() / act() / reset() or write a YAML config.