Open Source Robotics

精選高品質的開源機器人專案、工具與軟體,推動機器人社群向前發展。

robot2:讓代理透過純 HTTP 控制堆疊驅動 SO-101

SO-101 Open Robot Arm

  • 製作者: Alex Nichol

Alex Nichol 用 Go 從零重寫了他的居家機器人軟體堆疊,把整套系統放在一個小型 HTTP API 後面,然後讓一個通用代理來操作它。這個儲存庫直白地形容自己是「嘗試以更乾淨(由人驅動)的方式重寫我大部分的居家機器人堆疊」:在一個整體目的就是讓模型操控手臂的專案中,「由人驅動」正是重點。

API

端點分為三組,全部回傳以 {"data": ...} 或 {"error": ...} 包裝的 JSON,並以非 200 的狀態碼區分機器人故障與錯誤請求:

- 馬達:/motor/names、/motor/status、/motor/limits、/motor/move(原始位置,範圍 0–4095),以及 /motor/stoprelax,這是一個阻塞式呼叫,用來抑制原本會讓馬達朝扭矩方向逐漸放鬆的機制。最後這個端點的存在,是為了讓手臂在模型思考時不會下垂。 - 運動學:/kinematics/limitsangles、/kinematics/currentangles 與 /kinematics/move;後者以弧度接收每個關節角度,且必須全部指定。 - 相機:/camera/tracknames 與 /camera/snapshot,後者回傳指定軌道的原始 JPEG 位元組。

這就是代理所需要的全部介面:讀取關節角度、透過相機觀看、下達新的角度指令。

儲存庫裡有什麼

全部以 Go 撰寫,包含 API、透過 V4L2 擷取相機影像以及運動學的套件,另有一組命令列工具,揭示了這個專案實際上需要哪些東西:calibrate 與 calibrate_single、用來找出桌面位置的 fit_to_table 與 manual_table_fit、用於逆向運動學定位的 ik_move、kinematics_log、用於記錄放置位置的 placement_data、用於指派伺服機 ID 的 setid,以及 timelapse。

為什麼端點設計很重要

大多數代理操控手臂的展示,都是包裝一個現有的框架。這個專案則從「代理就是會發出 HTTP 請求的東西」這個觀察出發,打造出能讓它完成有用工作的最小介面:讀者花一個下午就能把這套設計搬到另一支手臂上。

詳細資訊

  • arm: SO-101
  • agent: GPT-6 Astra
  • licence: No licence file — all rights reserved by default
  • notable: stoprelax endpoint holds position while the model is thinking
  • language: Go
  • difficulty: Advanced
  • api_surface: /motor, /kinematics, /camera over HTTP with JSON
  • repository_opened: 18 July 2026

照片與影片

  • unixpickle/robot2: The Go control stack: HTTP API, camera capture, kinematics, and the calibration and table-fitting tools.
  • Astra arranges a circle: The agent arranging blocks into a circle on the table through the HTTP API.

連結

  • 製作者: https://github.com/unixpickle

本網站需要 JavaScript 才能正常運作。請啟用 JavaScript 以瀏覽我們的開源機器人專案。