I2RT Python API

A Python client library for interacting with I2RT products — designed for learning-based robotics, teleoperation, and real-world deployment.

Full documentation: see the docs/ folder or the hosted web docs.

Features

• Plug-and-play Python interface for YAM arms and Flow Base
• Real-time robot control via CAN bus (DM series motors)
• MuJoCo gravity compensation, simulation, and URDF/MJCF models
• Gripper force control and auto-calibration
• Bimanual teleoperation and trajectory record & replay
• Policy-deployment ready — works with standard robot learning pipelines

Installation

git clone https://github.com/i2rt-robotics/i2rt.git && cd i2rt
curl -LsSf https://astral.sh/uv/install.sh | sh
source $HOME/.local/bin/env
uv venv --python 3.11
source .venv/bin/activate

sudo apt update
sudo apt install build-essential python3-dev linux-headers-$(uname -r)
uv pip install -e .

CAN Bus Setup

# Check detected CAN devices
ls -l /sys/class/net/can*

# Bring up interface at 1 Mbit/s
sudo ip link set can0 up type can bitrate 1000000

# Auto-enable on boot
sudo sh devices/install_devices.sh

# Reset unresponsive adapter
sh scripts/reset_all_can.sh

For persistent CAN names across multi-arm setups (YAM Cell), see docs/getting-started/hardware-setup.md.

YAM Arm

Zero-gravity mode

python i2rt/robots/motor_chain_robot.py --channel can0 --gripper_type linear_4310

Python API

from i2rt.robots.motor_chain_robot import get_yam_robot
import numpy as np

robot = get_yam_robot(channel="can0", gripper_type="linear_4310")

# Read joint positions (radians)
q = robot.get_joint_pos()   # shape: (6,)

# Command a target configuration
robot.command_joint_pos(np.zeros(6))

Leader-follower teleoperation

# Follower arm
python examples/minimum_gello/minimum_gello.py --gripper linear_4310 --mode follower --can-channel can0 --bilateral_kp 0.2

# Leader arm (teaching handle)
python examples/minimum_gello/minimum_gello.py --gripper yam_teaching_handle --mode leader --can-channel can1 --bilateral_kp 0.2

• Top button (press once): enable synchronisation — follower tracks leader
• Top button (press again): disable synchronisation
• --bilateral_kp controls resistance felt on the leader (0.1–0.2 recommended)

To inspect leader arm output:

python scripts/run_yam_leader.py --channel $CAN_CHANNEL

MuJoCo visualiser

python examples/minimum_gello/minimum_gello.py --mode visualizer_local

Gripper Types

Gripper	Motor	Notes
crank_4310	DM4310	Zero-linkage crank — minimises gripper width
linear_3507	DM3507	Lightweight linear; start closed or run calibration
linear_4310	DM4310	Standard linear; slightly more force than 3507
yam_teaching_handle	—	Leader arm handle with trigger + 2 buttons. See docs/products/yam-leader.md

The linear grippers require calibration because their motor travels more than 2π radians over the full stroke — either start with the gripper fully closed, or run the calibration routine.

Flow Base

# Joystick demo
python i2rt/flow_base/flow_base_controller.py

from i2rt.flow_base.flow_base_client import FlowBaseClient

client = FlowBaseClient(host="172.6.2.20")
client.set_target_velocity([0.1, 0.0, 0.0], frame="local")

Full setup, remote layout, API reference, and linear rail docs: docs/products/flow-base.md.

Examples

Example	Location	Docs
Bimanual lead-follower	examples/bimanual_lead_follower/	docs/examples/bimanual-teleoperation.md
Record & replay trajectory	examples/record_replay_trajectory/	docs/examples/record-replay.md
Single motor PD control	examples/single_motor_position_pd_control/	docs/examples/motor-control.md
MuJoCo control interface	examples/control_with_mujoco/	docs/examples/control-with-mujoco.md

Advanced: Motor Configuration

Safety timeout

The factory default is a 400 ms timeout — motors enter damping mode if no command is received within 400 ms.

# Disable timeout (advanced users only — run twice)
python i2rt/motor_config_tool/set_timeout.py --channel can0
python i2rt/motor_config_tool/set_timeout.py --channel can0

# Re-enable timeout
python i2rt/motor_config_tool/set_timeout.py --channel can0 --timeout

⚠️ Without the timeout, a failed gravity-compensation loop can produce uncontrolled torque. If you disable it, always initialise with a PD target:

robot = get_yam_robot(channel="can0", zero_gravity_mode=False)

Zero motor offsets

python i2rt/motor_config_tool/set_zero.py --channel can0 --motor_id 1

Run for each motor ID (1–6 for a standard YAM).

Contributing

Pull requests welcome. Open an issue to request examples or report bugs.

License

MIT License — see LICENSE.

Support

• Email: support@i2rt.com
• Sales: sales@i2rt.com

Acknowledgments

• TidyBot++ — Flow Base hardware and control inspired by TidyBot++
• GELLO — Teleoperation design inspired by GELLO