Skip to content

HighTorque-Robotics/Panthera-HT_Main

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

28 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Panthera-HT 🐆

中文en

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

leader

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_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
  1. 安装依赖并运行示例程序(详见 SDK 仓库的 README)。

第一个示例

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

🤝 社区贡献

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

完全开放

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

我们需要你

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

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

欢迎提交 Issue 和 Pull Request!

🔗 相关文档与链接

产品发布

基础控制

视觉与抓取

遥操与数据采集

交流群

  • QQ群:Panthera-HT交流群(1035440629)

相关项目

🚀 未来规划

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

高级传统控制

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

具身智能方向

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

👥 贡献者

⭐ Star History

Star History Chart

⚠️ 免责声明

Note

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


Panthera-HT 🐆

中文en

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

leader

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:

Master-Slave Teleoperated Grasping:

🧭 Capability Status

Direction Supported
Basic Control Position, velocity, torque, and impedance control
Compensation Control Gravity compensation and gravity-friction compensation
Teleoperation Dual-arm master-slave teleoperation and drag teaching
Vision Visual servoing and color-block tracking
Grasping GraspNet grasp pose estimation demo
Robot Learning LeRobot data collection and inference
ROS2 Ecosystem Drivers, control, and simulation support

🎯 Use Cases

  • University courses: Kinematics, dynamics, motor control, communication protocols, ROS2, and robot perception teaching.
  • Robotics clubs and maker projects: Lower the barrier to building, controlling, and demonstrating a robotic arm.
  • Theory-to-hardware practice: Help students and makers understand mechanical design, control algorithms, and real hardware debugging workflows.
  • Hackathon development: Quickly combine arm hardware, cameras, grippers, and algorithms under short development cycles.
  • Vision-based grasping research: Visual servoing, GraspNet grasp pose estimation, color tracking, and point-cloud experiments.
  • Embodied AI data collection: Collect imitation learning data with teleoperation, drag teaching, and LeRobot.
  • ROS2 control and simulation training: Driver development, control pipelines, simulation, and system integration.

🗃️ Repository

Repository License Description
Panthera-HT_Main MIT Main project repository, including project introduction, repository links, and feature requests.
Panthera-HT_Model MIT SolidWorks original design files, sheet metal unfolding diagrams, 3D printing files, and Bill of Materials (BOM).
Panthera-HT_SDK MIT C++/Python SDK development package, providing quick-start example code and development toolchain.
Panthera-HT_ROS2 MIT ROS2 development package providing robotic arm drivers, control, and simulation support.
Panthera-HT_lerobot MIT LeRobot integration package, supporting imitation learning and robot learning algorithms.

🚀 Quick Start

Choose Your Starting Path

Goal Recommended Entry What You Will Find
Learn the hardware and structure Panthera-HT_Model SolidWorks source files, sheet-metal drawings, 3D-printing files, and BOM
Run basic control examples Panthera-HT_SDK C++/Python SDK, installation notes, and position/velocity/torque control examples
Develop with ROS2 Panthera-HT_ROS2 ROS2 drivers, control, and simulation support
Experiment with imitation learning Panthera-HT_lerobot LeRobot data collection, inference, and robot learning integration

Hardware Preparation

  1. Check the Panthera-HT_Model repository for the complete Bill of Materials (BOM).
  2. Prepare files for sheet metal processing, 3D printing, and CNC machining.
  3. Purchase HighTorque joint modules and other electronic components.
  4. Regarding the selection of power supply devices, we recommend using an adjustable power supply to provide stable 24V 15A power to the device.
  • Sets purchased through our sales channels will include a 220V to 24V 15A power adapter (three-prong plug). If the power supply voltage in your region is 220V, you can directly use this adapter.

Software Environment

  1. Clone the SDK repository:
git clone https://github.com/HighTorque-Robotics/Panthera-HT_SDK.git
cd Panthera-HT_SDK
  1. Install dependencies and run example programs (see SDK repository README for details).

First Example

Refer to the example code in Panthera-HT_SDK to quickly get started with robotic arm control.

🤝 Community Contribution

This project belongs to everyone who loves robotics!

Fully Open

  • Motor Selection: Can be replaced with joint modules from other brands
  • Structural Modification: Can change size, materials, and appearance according to needs
  • Algorithm Optimization: Welcome to submit better control algorithms and features
  • Feature Extension: Add new features like vision, force control, AI, etc.

We Need You

The project may not be perfect in many small details, and we need the community's help to improve it together:

  • 📝 Improve documentation and tutorials
  • 🐛 Report and fix bugs
  • 💡 Propose new feature suggestions
  • 🔧 Optimize structural design
  • 📊 Share your use cases

Welcome to submit Issues and Pull Requests!

🔗 Related Documents and Links

Product Launch:

Basic Control:

Vision and Grasping:

Teleoperation and Data Collection:

Community:

  • QQ Group: Panthera-HT Community (1035440629)

Related Projects:

🚀 Future Roadmap

We will continue improving the current capabilities and expanding more demos for advanced control and embodied intelligence:

Advanced Traditional Control

  • Point-cloud obstacle avoidance
  • More visual servoing tasks
  • More traditional control algorithms
  • Grasp success evaluation and standardized experiment workflows

Embodied Intelligence

  • Integration of cutting-edge algorithms like Pi0, Pi0.5
  • RoboTWin2.0 adaptation
  • End-to-end learning
  • Multimodal perception and control

👥 Contributors

⭐ Star History

Star History Chart

⚠️ Disclaimer

Note

If you build or develop Panthera-HT based on this repository, you will be fully responsible for all physical and mental damages caused to you or others.

About

Introduction to the Panthera-HT robotic arm

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors