Installation

Package

uv pip install rfx-sdk

pip install rfx-sdk

uv add rfx-sdk

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

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.

rfx doctor

The doctor command checks:

Use --strict to fail on missing required dependencies:

rfx doctor --strict

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

Robot	Type	Interface	Status
SO-101	6-DOF arm	USB serial (Rust driver)	Ready
Unitree Go2	Quadruped	Ethernet (Zenoh transport)	Ready
Unitree G1	Humanoid	Ethernet (Zenoh transport)	In progress

Custom robots: implement observe() / act() / reset() or write a YAML config.