Panthera-HT 🐆

面向学生、创客、教学实验和机器人学习开发的开源六轴机械臂平台。

官方网站：Panthera-HT Hub

Panthera-HT 是一款开源六轴机械臂，使用高擎机电的行星关节模组。我们面向开发者提供可复用的统一控制接口，用于算法验证、课程实验、系统集成、具身智能数据采集及二次开发的标准化软硬件实验平台。

机械臂现有的控制方式包括 C++、Python 和 ROS2，拥有的一些功能：位置/速度/力矩控制、阻抗控制、重力补偿模式、重力补偿-摩擦力补偿模式、主从遥操（双臂）、拖动示教等。此外，还支持在 LeRobot 框架下进行数据采集和推理。最新开发 Demo 已覆盖视觉伺服、GraspNet 抓取位姿估计、视觉跟踪色块等方向，更多运行脚本请参考 SDK 文档。

✨ 项目起源与初心

这个项目的初心是让学生党能以更低的价格玩到更高性能的关节电机机械臂。

项目最初源自 Ragtime-LAB/Ragtime_Panthera 的开源工作，我们在此基础上进行了完善和优化。感谢原作者 wEch1ng(芝士榴莲肥牛) 的无私分享和开源精神！

为了方便学生学习如何从0到1搭建和控制机械臂，我们将从结构设计到控制算法统统开源，让每个人都能深入理解机械臂的工作原理。

后来项目原作者与高擎一拍即合，在高擎的支持下将项目完善落地，做成了一个更加完善的创客产品。但我们始终坚持开源理念，不对项目作出任何限制。

💡 设计理念

低成本 + 高性能

• 钣金框架：选择高性价比的钣金作为整体框架，保证强度的同时降低成本
• 3D打印 + CNC加工：配合3D打印和三轴CNC加工，实现灵活的结构设计
• 高性能关节模组：使用高擎机电的行星关节模组，在成本和性能间取得平衡

完全开源 + 可扩展

• 结构开源：提供 SolidWorks 原始设计文件、钣金展开图、3D 打印 STL 文件
• 算法开源：从底层控制到高级算法，所有代码完全开源
• 无限制修改：你可以根据需求自由更换电机、修改结构、改变外观
• 模块化设计：方便进行二次开发和功能扩展

📷 项目图片

⚙️ 控制示例

位置速度控制：

主从遥操：

主从遥操抓取：

🧭 能力状态

方向	已支持
基础控制	位置控制、速度控制、力矩控制、阻抗控制
补偿控制	重力补偿、重力补偿-摩擦力补偿
遥操作	双臂主从遥操、拖动示教
视觉能力	视觉伺服、色块视觉跟踪
抓取能力	GraspNet 抓取位姿估计 Demo
机器人学习	LeRobot 数据采集与推理
ROS2 生态	驱动、控制与仿真支持

🎯 适合的应用场景

• 高校课程实验：用于运动学、动力学、电机控制、通信协议、ROS2、机器人感知等课程教学。
• 机器人社团与创客项目：以较低门槛完成机械臂结构搭建、控制调试和 Demo 展示。
• 从理论到实物的完整实践：帮助学生和创客理解机械结构设计、控制算法和真实硬件调试流程。
• 黑客松快速开发：快速组合机械臂、相机、夹爪和算法模块，完成短周期项目验证。
• 视觉抓取算法验证：用于视觉伺服、GraspNet 抓取位姿估计、色块跟踪、点云处理等实验。
• 具身智能数据采集：结合主从遥操、拖动示教和 LeRobot，采集模仿学习数据。
• ROS2 控制与仿真教学：用于驱动开发、控制链路、仿真环境和系统集成训练。

🗃️ 仓库

仓库	许可证	描述
Panthera-HT_Main	MIT	主项目仓库，包含项目介绍、仓库链接和功能请求。
Panthera-HT_Model	MIT	SolidWorks 原始设计文件、钣金图、3D 打印文件和物料清单（BOM）。
Panthera-HT_SDK	MIT	C++/Python SDK 开发包，提供快速上手的示例代码与开发工具链。
Panthera-HT_ROS2	MIT	ROS2 开发包，提供机械臂的驱动、控制与仿真支持。
Panthera-HT_lerobot	MIT	LeRobot 集成包，支持模仿学习和机器人学习算法。
Panthera-HT_Extensions	MIT	开发案例仓库，包括d405相机手眼标定、视觉伺服等流程的实现。
Panthera-HT_Host	MIT	机械臂上位机Web可视化控制平台与SDK示例集成

🚀 快速开始

选择你的起步路径

目标	推荐入口	你会找到
了解硬件与结构	Panthera-HT_Model	SolidWorks 原始设计文件、钣金图、3D 打印文件、BOM
运行基础控制示例	Panthera-HT_SDK	C++/Python SDK、安装说明、位置/速度/力矩控制示例
使用 ROS2 开发	Panthera-HT_ROS2	ROS2 驱动、控制与仿真支持
进行模仿学习实验	Panthera-HT_lerobot	LeRobot 数据采集、推理与机器人学习集成

硬件准备

1. 查看 Panthera-HT_Model 仓库获取完整的物料清单（BOM）。
2. 准备钣金加工、3D 打印和 CNC 加工的文件。
3. 采购高擎机电的关节模组和其他电子元件。
4. 关于供电器件的选择，我们建议使用可调电源为设备提供 24V 15A 稳定供电。

• 通过我们的销售渠道购买的套装将包括一个 220V 转 24V 15A 的电源适配器（三线插头）。若您所在地区的供电电压为 220V，您可以直接使用该适配器。

软件环境

1. 克隆 SDK 仓库：

git clone https://github.com/HighTorque-Robotics/Panthera-HT_SDK.git
cd Panthera-HT_SDK

2. 安装依赖并运行示例程序（详见 SDK 仓库的 README）。

第一个示例

参考 Panthera-HT_SDK 中的示例代码，快速上手机械臂控制。

🤝 社区贡献

这个项目属于每一个热爱机器人的人！

完全开放

• ✅ 电机选择：可以更换为其他品牌的关节模组
• ✅ 结构修改：可以根据需求改变尺寸、材料、外观
• ✅ 算法优化：欢迎提交更好的控制算法和功能
• ✅ 功能扩展：添加视觉、力控、AI等新功能

我们需要你

项目在很多小细节上可能做得不够完善，我们需要社区的力量一起来完善：

• 📝 完善文档和教程
• 🐛 报告和修复bug
• 💡 提出新的功能建议
• 🔧 优化结构设计
• 📊 分享你的使用案例

欢迎提交 Issue 和 Pull Request！

🔗 相关文档与链接

• Panthera-HT 官方网站
• 快速使用指南
• 参数手册
• 机械臂各项参数

产品发布：

• Panthera-HT 产品发布文章：https://mp.weixin.qq.com/s/Q9vUWf82evteEj3tVbXJsQ

基础控制：

• SDK配置与上手：https://www.bilibili.com/video/BV1SxwYzhEai/

视觉与抓取：

• GraspNet抓取位姿估计：https://www.bilibili.com/video/BV13KcDzLE3F/
• 视觉跟踪色块：https://www.bilibili.com/video/BV1JQPfz4EPN
• 视觉伺服 Demo：待补充视频或文档链接

遥操与数据采集：

• 主从遥操打乒乓球：https://www.bilibili.com/video/BV1KprhBPE26/
• 移植LeRobot数据集进行模仿学习：https://www.bilibili.com/video/BV1GLi1BqETz/

交流群：

• QQ群：Panthera-HT交流群（1035440629）

相关项目：

• 夹爪设计参考：UMI (Universal Manipulation Interface)

🚀 未来规划

我们将持续完善当前能力，并继续扩展更多高级控制和具身智能方向的 Demo：

高级传统控制

• 点云避障
• 更多视觉伺服任务
• 更多传统控制算法
• 抓取成功率评估与实验流程标准化

具身智能方向

• Pi0、Pi0.5 等前沿算法集成
• RoboTWin2.0 适配
• 端到端学习
• 多模态感知与控制

👥 贡献者

⭐ Star History

⚠️ 免责声明

[!NOTE] 如果您基于此仓库构建或开发 Panthera-HT，您将对其对您或他人造成的所有身体和精神损害承担全部责任。

---

Panthera-HT 🐆

An open-source six-axis robotic arm platform for students, makers, education and robot learning development.

Official Website: Panthera-HT Hub

Panthera-HT is an open-source six-axis robotic arm that uses HighTorque planetary joint modules. It provides developers with a reusable unified control interface, serving as a standardized hardware and software experimental platform for algorithm verification, course experiments, system integration, embodied AI data collection, and secondary development.

The current control methods include C++, Python, and ROS2, with features including position/velocity/torque control, impedance control, gravity compensation mode, gravity-friction compensation mode, master-slave teleoperation, drag teaching, and more. It also supports data collection and inference under the LeRobot framework. Recent development demos include visual servoing, GraspNet grasp pose estimation, and color-block visual tracking. For more operation scripts, please refer to the SDK documentation.

✨ Project Origin and Mission

The mission of this project is to enable students to access high-performance joint motor robotic arms at a lower cost.

The project originally stems from the open-source work of Ragtime-LAB/Ragtime_Panthera, which we have refined and optimized. Thanks to the original author wEch1ng (芝士榴莲肥牛) for their selfless sharing and open-source spirit!

To help students learn how to build and control a robotic arm from scratch (0 to 1), we have open-sourced everything from structural design to control algorithms, allowing everyone to deeply understand how robotic arms work.

Later, the original project author and HighTorque hit it off, and with HighTorque's support, the project was refined and brought to market as a more complete maker product. However, we always adhere to the open-source philosophy and impose no restrictions on the project.

💡 Design Philosophy

Low Cost + High Performance

• Sheet Metal Frame: High cost-performance sheet metal as the main frame, ensuring strength while reducing costs
• 3D Printing + CNC Machining: Combined with 3D printing and 3-axis CNC machining for flexible structural design
• High-Performance Joint Modules: Using HighTorque planetary joint modules, balancing cost and performance

Fully Open Source + Scalable

• Open Structure: Provides SolidWorks original design files, sheet metal unfolding diagrams, and 3D printing STL files
• Open Algorithms: All code from low-level control to advanced algorithms is fully open source
• Unrestricted Modification: You can freely replace motors, modify structures, and change appearance according to your needs
• Modular Design: Facilitates secondary development and feature expansion

📷 Project Images

⚙️ Control Examples

Position and Speed Control:

Master-Slave Teleoperation:

Mast