so100 机械臂 MuJoCo 仿真用户界面

so100-mujoco-sim

机械臂 ⭐⭐⭐☆☆ (3/5) 🧩 软硬件结合 已发布
lachlanhurst 32 Stars MIT BOM 完整度: /5 教程完整度: /5

项目简介

so100机械臂模拟,使用MuJoCo、LeRobot和Qt。


so100-mujoco-sim 是一个专为 so100(so-arm100)机械臂设计的仿真与用户交互界面,旨在解决低成本机械臂在开发与测试过程中缺乏直观仿真环境的问题。该项目基于 MuJoCo 物理引擎构建高保真仿真模型,并利用 PySide6(Qt)开发图形界面,让用户能够同时控制真实机械臂与仿真模型。核心功能包括:通过用户界面独立调节各关节角度以驱动真实或仿真机械臂;通过移动真实机械臂实时同步仿真模型;记录控制过程中的关节角度数据;以及回放已记录的运动轨迹。项目特别强调“无硬件也可运行”的设计理念,即使没有连接真实 so100 机械臂,用户仍可完整体验仿真控制与数据记录功能。技术栈方面,项目采用 Pixi 作为包管理工具,依赖 MuJoCo 进行物理仿真与可视化,PySide6 构建交互界面,LeRobot 库负责机械臂控制与校准。适用场景包括:机器人算法开发与验证、运动规划测试、远程操作教学、以及低成本机械臂的离线编程。对于连接真实机械臂的用户,项目提供了详细的 USB 端口识别与校准流程指引,确保仿真模型与真实机械臂的位姿精确匹配。此外,项目还集成了单元测试功能,便于开发者验证代码正确性。整体而言,so100-mujoco-sim 为 so100 机械臂的开发者与爱好者提供了一个集仿真、控制、记录与回放于一体的完整工具链,显著降低了机械臂应用开发的硬件依赖门槛。

项目特点

**双模式控制**:支持通过用户界面独立控制仿真或真实机械臂的关节角度。
**真实-仿真同步**:可以通过移动真实机械臂来实时驱动仿真模型。
**动作记录与回放**:能够记录机械臂的关节角度序列,并在仿真或真实机械臂上回放。
**依赖管理**:使用 Pixi 包管理工具,简化依赖安装和环境配置。
**模块化设计**:基于 LeRobot 进行真实机械臂控制,基于 MuJoCo Menagerie 获取仿真模型。

技术规格

仿真引擎
图形界面框架
机器人控制库
目标机器人
包管理工具
仿真模型来源
操作系统

项目资源

物料清单 (BOM)

物料名称 数量 参考价格 备注
so100 (SO-ARM100) 机械臂 1 可选,用于真实控制
USB 连接线 1 连接机械臂到电脑
Pixi 1 包管理工具
Python 环境 1 通过 Pixi 管理

所需工具

工具用途是否必需
电脑 运行仿真和用户界面 ✅ 是
USB 端口 连接真实机械臂 ▢ 推荐

能力画像

记忆与知识检索
逻辑推演
表达与交流
感知与观察
数理与计算
动手与操作
狂热与坚持
创造与创新

所需技能

🔧 **动手能力**:能够连接和校准真实 so100 机械臂(可选)。 💻 **编程能力**:熟悉命令行操作,了解 Pixi、Python 基础。 ⚡ **电子电路**:无需。

适用场景

在购买或组装真实 so100 机械臂之前,通过仿真进行算法开发和验证。
教学和演示机器人运动学、控制算法。
记录和回放机械臂动作,用于数据采集或任务复现。
作为 LeRobot 和 MuJoCo 集成的参考实现。