RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的**机器人统一编程接口框架**。项目采用创新的**双标准驱动**架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"**一次编程、多机部署、厂商无感替换**"的目标。 ### 核心特性 🎯 **双标准驱动** - 严格遵循中国国家标准 (GB/T 29824, GB/T 47245) - 完全兼容 ROS2 消息/服务/Action 模型 - 国标与 ROS2 双向自动映射 🔌 **插件化架构** - 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层) - 支持插件化加载各厂商适配器 - 新增机器人厂商无需改动上层应用 🤖 **广泛支持** - **工业机械臂**: ABB, KUKA, FANUC, UR, 埃斯顿,汇川 - **人形机器人**: 优必选 Walker X, 小米 CyberOne - **移动机器人**: AGV, AMR, 轮式/履带式平台 - **服务机器人**: 导引、配送、清洁机器人 ⚡ **强大功能** - 任务级编程接口 - 运动控制归一化 - IO 与外设统一控制 - 故障与安全标准化 - 人形机器人专用扩展 (步态、平衡、双臂协调)
| Files | Last commit | Last update |
|---|---|---|
| 2 days ago | ||
| 2 days ago | ||
| 4 months ago | ||
| 2 days ago | ||
| 6 months ago | ||
| 2 days ago | ||
| 2 days ago | ||
| 2 days ago | ||
| 4 months ago | ||
| 2 days ago | ||
| 4 months ago | ||
| 2 days ago | ||
| 6 months ago | ||
| 2 days ago |
RobotX - 机器人统一编程接口框架
🤖 项目名称
RobotX - 机器人统一编程接口框架
(Robot Unified Programming Interface Framework)
📖 项目简介
RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的机器人统一编程接口框架。项目采用创新的双标准驱动架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"一次编程、多机部署、厂商无感替换"的目标。
核心特性
🎯 双标准驱动
- 严格遵循中国国家标准 (GB/T 29824, GB/T 47245)
- ROS2 兼容: 消息级双向映射 + 桥接节点 (可选组件)
- 国标与 ROS2 双向自动映射
🔌 插件化架构
- 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层)
- 支持插件化加载各厂商适配器
- 新增机器人厂商无需改动上层应用
🤖 广泛支持
- 工业机械臂: ABB, KUKA, FANUC, UR, 埃斯顿,汇川
- 人形机器人: 优必选 Walker X, 小米 CyberOne
- 移动机器人: AGV, AMR, 轮式/履带式平台
- 服务机器人: 导引、配送、清洁机器人
⚡ 强大功能
- 任务级编程接口
- 运动控制归一化
- IO 与外设统一控制
- 故障与安全标准化
- 人形机器人专用扩展 (步态、平衡、双臂协调)
快速开始
from robot_unified_api import UnifiedRobotInterface, Pose, Position
from robot_unified_api.plugins.ubtech_adapter import UBTECHRobotAdapter
# 创建适配器
adapter = UBTECHRobotAdapter(ip="YOUR_ROBOT_IP")
# 创建统一接口
robot = UnifiedRobotInterface("walker_x_001", adapter)
# 启动接口、注册(连接)机器人并控制
await robot.start()
await robot.register_robot({"ip": "YOUR_ROBOT_IP"})
await robot.move_to_pose(
pose=Pose(position=Position(0.5, 0.3, 0.4)),
velocity=0.5
)
项目结构
robotx/
├── .github/ # GitHub 配置
│ └── workflows/ # CI/CD 工作流
│ ├── ci.yml # 持续集成
│ └── release.yml # 发布流程
├── robot_unified_api/ # 核心框架
│ ├── core.py # 核心数据类型
│ ├── interface.py # 统一接口层
│ ├── plugin.py # 插件规范
│ ├── abstraction_layer.py # 多标准兼容抽象层
│ ├── ros2_bridge.py # ROS2 桥接节点 (可选组件)
│ ├── humanoid_extension.py # 人形机器人扩展
│ ├── plugins/ # 厂商适配器
│ ├── examples/ # 示例代码
│ └── tests/ # 框架测试
├── docs/ # 项目文档
│ ├── api/ # API 参考文档
│ ├── adapters/ # 适配器文档
│ ├── humanoid/ # 人形机器人文档
│ ├── ARCHITECTURE.md # 架构设计
│ ├── PROJECT_OVERVIEW.md # 项目总览
│ ├── PROJECT_STRUCTURE.md # 项目结构
│ ├── ROS2_COMPATIBILITY.md # ROS2 兼容性
│ ├── HUMANOID_ROBOTICS_GUIDE.md # 人形机器人指南
│ └── VERSION.md # 版本历史
├── implementations/ # 厂商实现文档
├── standards/ # 国标文档
├── tests/ # 集成测试
├── .pre-commit-config.yaml # pre-commit 配置
├── CONTRIBUTING.md # 贡献指南
├── CHANGELOG.md # 更新日志
└── README.md # 项目说明
支持的机器人
| 厂商 | 型号 | 类型 | 状态 |
|---|---|---|---|
| ABB | IRB 系列 | 工业机械臂 | ✅ 已实现 |
| KUKA | KR 系列 | 工业机械臂 | ✅ 已实现 |
| FANUC | R-30iB | 工业机械臂 | ✅ 已实现 |
| UR | UR5/UR10 | 协作机器人 | ✅ 已实现 |
| 埃斯顿 | ESTUN | 工业机械臂 | ✅ 已实现 |
| 汇川 | INOVANCE | 工业机械臂 | ✅ 已实现 |
| 优必选 | Walker X | 人形机器人 | ✅ 已实现 |
| 小米 | CyberOne | 人形机器人 | ✅ 已实现 |
标准遵循
- GB/T 29824-2013《工业机器人 用户编程指令》
- GB/T 47245-2026《机器人智能控制系统总体架构》
- GB/T 44251-2024《腿式机器人性能及试验方法》
- ROS2 消息/服务/Action 模型
安装
pip install robotx
开发模式安装:
git clone https://gitcode.com/hunyuan2026/RobotX.git
cd RobotX
pip install -e "./robot_unified_api[dev]"
# 安装 pre-commit 钩子
pre-commit install
文档
版本
当前版本:v0.3.0
许可证
MIT License
联系方式
RobotX - 让机器人编程更简单!🚀
Introduction
RobotX 是一个基于中国国家标准 (GB/T) 和 ROS2 事实国际标准的**机器人统一编程接口框架**。项目采用创新的**双标准驱动**架构,通过插件化设计屏蔽不同厂商机器人的硬件差异,实现"**一次编程、多机部署、厂商无感替换**"的目标。 ### 核心特性 🎯 **双标准驱动** - 严格遵循中国国家标准 (GB/T 29824, GB/T 47245) - 完全兼容 ROS2 消息/服务/Action 模型 - 国标与 ROS2 双向自动映射 🔌 **插件化架构** - 五层分层设计 (应用层→统一接口层→抽象层→适配层→硬件层) - 支持插件化加载各厂商适配器 - 新增机器人厂商无需改动上层应用 🤖 **广泛支持** - **工业机械臂**: ABB, KUKA, FANUC, UR, 埃斯顿,汇川 - **人形机器人**: 优必选 Walker X, 小米 CyberOne - **移动机器人**: AGV, AMR, 轮式/履带式平台 - **服务机器人**: 导引、配送、清洁机器人 ⚡ **强大功能** - 任务级编程接口 - 运动控制归一化 - IO 与外设统一控制 - 故障与安全标准化 - 人形机器人专用扩展 (步态、平衡、双臂协调)
Customize your domain