Skip to content

chenlongos/AKA-00

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

166 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

AKA-00

🤖 全开源辰龙AI教育机器人,降低具身智能学习门槛!

💰 299¥,一只耳机价,让人手一台AI机器人成为可能!

展示图片

视频:B站辰龙机器人捡球视频

📰 新闻

🙌 关于我们

从2024年的初步构想,到2025年依托开源机械臂项目实现技术突破,再到2025年底提出概念:让人手一台机器人成为可能!这一路,有不少优秀的伙伴参与进来,和我们一起把机器人硬件做的更加低成本,共同把这个开源项目做得更好!

终于在2026年初,299元辰龙AI教育机器人正式落地!它能完成"识别网球位置—自主移动—完成捡球动作"的视觉-运动-执行完整闭环。软硬件开源,使得学习者可以进行二次开发改造,降低具身智能的学习门槛。辰龙机器人是一个面向教学的低成本AI机器人,通过提供简单的平台实现多种算法的训练和仿真。

💬 交流社区

qq qq

QQ群:901307286

📖 文档

辰龙AI教育机器人技术文档

💰 总成本

299¥ 即可购买辰龙AI教育机器人组件套装,微信小店购买:[链接]

🚀 快速开始

  1. 💰 购买硬件:[购买链接]
  2. 🔨 组装:[组装文档/视频链接]
  3. 💻 软件课程,请报名训练营学习:[训练营课程链接]

📦 部署

将项目打包为单个可执行文件,直接拷贝到 SG2002 控制板上运行。

# 构建(在开发机上执行)
./build_release.sh              # 使用已有前端
./build_release.sh --rebuild    # 重新构建前端后打包

# 输出: dist/aka-server (约 9MB 自解压可执行文件)

首次部署

# 1. 拷贝 aka-server 到控制板
scp dist/aka-server root@<robot>:/usr/local/bin/

# 2. 运行首次初始化(解压 + 配置热点 + 开机自启)
ssh root@<robot> 'aka-server --init'

--init 会自动完成:

  • 解压项目文件到 /root/AKA-00
  • 配置 AP 热点(SSID 基于 MAC 地址唯一生成)
  • 配置 DHCP + 写入 S98apstart / S99webstart 自启脚本
  • 立即启动热点

更新部署

# 重新构建并拷贝,然后清除旧数据重启
scp dist/aka-server root@<robot>:/usr/local/bin/
ssh root@<robot> 'rm -rf /root/AKA-00 && aka-server'

热点信息

  • SSID: chenlong-robot-xxxxx(基于设备 MAC 地址生成)
  • 网关: 192.168.4.1
  • 连接热点后浏览器访问 http://192.168.4.1 即可控制

目前功能

✅ 已完成

功能 说明
机械臂控制 控制机械臂完成抓取和释放动作
底盘运动 N20 电机差速控制,支持前进/后退/转向
Web API 提供 HTTP 接口远程控制机器人
Web 界面 React 前端,可远程控制机器人运动和夹爪

代码结构

AKA-00/
├── run.py                # Web 服务器入口
├── build_release.sh      # 打包为单文件可执行程序
├── init_ap_web.sh        # 热点 + 自启配置脚本
├── tennis_hunter.py      # 机器人主程序
├── app/                  # Flask Web 应用
├── src/                  # 硬件控制模块(机械臂、电机、摄像头)
├── frontend/             # React 前端
└── models/               # YOLOv8 模型文件

详细说明见 [文档](./docs/src/06-development/structure.md)

技术栈

后端

技术 用途
Python 3.11 核心语言
Flask Web 框架
pyserial 串口通信(舵机)
python-periphery PWM 控制

前端

技术 用途
React 19 UI 框架
TypeScript 类型安全
Vite 构建工具

硬件

设备 型号
开发板 LicheeRV Nano
机械臂舵机 ZL-ZP10S
电机 N20 直流减速电机

环境变量

变量名 默认值 说明
APP_HTTP_PORT 80 (Linux) / 5000 (Windows) HTTP 服务端口
APP_HTTPS_PORT 443 (Linux) / 5443 (Windows) HTTPS 服务端口
APP_CERT_PATH /root/AKA-00/cert.pem HTTPS 证书路径
APP_KEY_PATH /root/AKA-00/key.pem HTTPS 密钥路径

API 接口

获取 IP 地址

GET /api/ip

响应:

{
  "ip": "192.168.1.100"
}

控制接口

GET /api/control?action=<action>&speed=<speed>&time=<time>

参数说明:

参数 类型 说明
action string 动作:up, down, left, right, stop, grab, release
speed int 速度 0-50
time int 持续时间(毫秒)

示例:

# 前进
curl "http://192.168.1.100/api/control?action=up&speed=30&time=1000"

# 抓取
curl "http://192.168.1.100/api/control?action=grab"

# 释放
curl "http://192.168.1.100/api/control?action=release"

硬件配件详情

机械臂

  • 型号: ZL-ZP10S 或 STS3215
  • 通信: 串口 UART (/dev/ttyACM0, 115200 波特率)

电机

  • 型号: N20 直流减速电机
  • 控制: PWM 调速
  • 左电机: chip=4, ch1=0, ch2=1
  • 右电机: chip=4, ch2=2, ch3=3

🙏 致谢

Contributors Last Commit

感谢所有为 AKA-00 做出贡献的人!

BoBoDai
BoBoDai
shzhxh
shzhxh
moyufei-MAX
moyufei-MAX
yydawx
yydawx

💪 贡献

👋 想要为 AKA-00 做出贡献吗?请参阅 CONTRIBUTING.md,了解如何参与。

免责声明

About

阿卡0号开源机器人

Resources

License

Contributing

Stars

Watchers

Forks

Packages

 
 
 

Contributors