so101-bringup

Installation
SKILL.md

SO-101 Hardware Bring-Up, Camera Verification & Stage 3 "Hello World"

Follow this staged workflow under R1–R16 (auto-advancing across software, --dry-run, and read-only steps without extra confirmation prompts) to bring up an SO-101 follower arm (so101_follower, 6× Feetech STS3215 servos) and 1 or more cameras (minimal setup: arm + 1 camera; recommended setup: fixed/overhead + wrist camera) using safety_rules.md, hardware_limits.md, and tabletop_pick_place.json. The fast path to Hello World is Stage 0 → 1 → 2 → 3; optional Stage 4 runs afterwards (required before Stage 5):

  1. Stage 0 — Environment, NOTES.md & Dedicated tmux Session robot (R11–R16, auto-advances to Stage 1):
    • Summarize safety and working rules R1–R16 from safety_rules.md before touching hardware.
    • Install with uv and shallow clones. LeRobot provides lerobot-find-port, lerobot-calibrate, motor drivers, and forward/inverse kinematics (RobotKinematics, kinematics extra); SO-ARM100 is only needed for the URDF and its meshes, so sparse-checkout Simulation/SO101. Check ffmpeg, and initialize NOTES.md and git (R12, R13):
      uv venv .venv && source .venv/bin/activate
      git clone --depth 1 https://github.com/huggingface/lerobot repos/lerobot
      uv pip install -e "repos/lerobot[feetech,kinematics]" opencv-python numpy
      git clone --depth 1 --filter=blob:none --sparse https://github.com/TheRobotStudio/SO-ARM100 repos/SO-ARM100
      git -C repos/SO-ARM100 sparse-checkout set Simulation/SO101
      
    • Create a persistent tmux session named robot (tmux new-session -d -s robot), verify two-way command/capture (tmux send-keys + tmux capture-pane), tell the human how to watch live (tmux attach -t robot), and proceed directly to Stage 1 without waiting for sign-off.
Installs
15
GitHub Stars
161
First Seen
3 days ago