hanppie

agent
Security Audit
Warn
Health Warn
  • License — License: Apache-2.0
  • Description — Repository has a description
  • Active repo — Last push 0 days ago
  • Low visibility — Only 5 GitHub stars
Code Pass
  • Code scan — Scanned 12 files during light audit, no dangerous patterns found
Permissions Pass
  • Permissions — No dangerous permissions requested

No AI report is available for this listing yet.

SUMMARY

Open-source RoboMaster workbench for driving, Python scripting and AI-assisted programming.

README.md
Hanppie 图标

Hanppie(憨皮)

English
License: Apache-2.0
macOS、Windows、Android、iOS
产品官网
下载 Hanppie
更新记录

RoboMaster 开源工作台。在电脑、手机和平板上驾驶机器人、编写 Python 脚本,也可以让 AI 帮你编程。

Hanppie

安装

从 GitHub Releases 下载对应文件,可用同页的 SHA256SUMS.txt 校验。

平台 安装方式
macOS 打开 DMG,将 Hanppie 拖入“应用程序”;发布包为 Apple Silicon(arm64)版本
Windows 运行 x64 MSI 安装包
Android 安装 APK,最低 Android 8.0
iPhone / iPad 最低 iOS 18.5;提供源码与未签名归档,需要使用 Xcode 签名安装,见开发指南

连接机器人

  1. 打开 Hanppie,进入“添加或更换机器人”。
  2. 选择直连或路由器模式:直连时加入机器人热点;路由器模式在 Hanppie 中填写 Wi-Fi 信息,让机器人扫描生成的二维码。
  3. 按系统提示允许本地网络访问,连接成功后即可开始使用。再次打开时,应用会尝试恢复上一次连接。

不需要 RoboMaster 官方 App。手动 IPv4/AppID 配置位于“诊断”页,供连接排障使用。

使用

任务 操作
驾驶 连接后进入驾驶舱,使用双摇杆,或用 WASD 移动、Q/E 转向、方向键控制云台;Esc 返回工作台。完整按键见“设置 → 快捷键”
编写脚本 在“脚本”页新建、导入 .py,或从预置脚本创建副本;保存到本机脚本库,再点击“运行脚本”。Lab 脚本使用机内 API 和 Python 3.6 语法,见 Lab 编程指南
AI 编程 在“设置 → 模型服务”选择供应商,填写 API Key、模型并测试配置;在“对话”页描述需求,检查完整脚本后确认执行
停止脚本 使用“停止脚本”。退出编辑器或取消 AI 生成不会停止已经启动的机内脚本

运行脚本会覆盖机器人的当前 Lab 运行槽位。执行动作前检查源码,并为机器人留出安全空间。文本对话会发送给你选择的模型供应商;密钥保存在应用私有数据中。

Python 与开发

Python 工具链使用 Python 3.10 与 uv:

git clone https://github.com/elonzh/hanppie.git
cd hanppie
uv sync

使用 from hanppie import Robot 访问原生直控,也可使用仓库内的 robomaster SDK fork。源码运行、构建、测试和 Python 示例见开发指南。

参考

实机验证范围见技术架构的能力矩阵。Hanppie 是独立项目,不隶属于 DJI。

自有代码采用 Apache License 2.0;内置 FFmpeg 的来源与许可证见第三方说明,DJI SDK 派生代码见 UPSTREAM.md。

Reviews (0)

No results found