源码系统概览
文章正文
Tiny Engineer 是开源 3D 打印桌面机器人项目源码，作用是给 AI 编程智能体一具身体，当 Cursor 等智能体在后台读文件、思考、写代码时，工位上的小机器人同步做动作，它运行于 ESP32 微控制器并暴露 REST 接口，任何能发 HTTP 请求的工具都能驱动。
项目由开发者 jamro 创建于 2026 年 8 月 21 日，2026 年 9 月 14 日最后更新，仓库 326 star 38 fork，固件版本号口径 v1.0.0，许可证为双协议，软件含固件集成脚本与文档采用 MIT，硬件设计含 3D 模型与电路板采用 CERN-OHL-S-2.0，名称与标识不在授权范围，更新日志随仓库提交持续记录。
源码简介
作者构建它的初衷是 AI 编程智能体独立工作时间越来越长，盯 IDE 太累，与其加状态栏，不如让一个微型队友坐在旁边可见地读码思考。
架构分三层，智能体产生事件，集成层转发为 HTTP 请求，机器人的 REST 接口接收后驱动硬件反应。
硬件上 ESP32-C3 经 I2C 总线连 PCA9685 驱动板控制五个舵机，同总线挂 0.91 寸 OLED 屏显示表情，I2S 音频经 MAX98357A 驱动喇叭。
官方提供 Cursor 钩子与 Antigravity CLI 两套集成，其他智能体按文档自行接入，动作含打字阅读思考响铃唤醒休眠等十余种。
和同类桌面状态提示硬件对比倒计时器，Tiny Engineer 的差异点在事件驱动的拟人化反馈。
| 对比维度 | Tiny Engineer | 翻页时钟 |
|---|---|---|
| 反馈形态 | 五舵机拟人动作加表情音效 | 数字或文字状态显示 |
| 接入方式 | REST API 对接任意智能体 | 仅显示固定信息 |
| 可玩性 | 3D 打印外壳可改 CAD 动画可扩展 | 出厂固化不可定制 |
| 软件协议 | 固件 MIT 开源 | 多为闭源固件 |
整体来看，想让 AI 编程工作流多一份实体反馈，或想入门嵌入式与舵机控制的开发者，这套从固件到结构的开源项目提供了全链路参考。
适用场景
- 程序员给 Cursor 智能体配一台实体状态伙伴。
- 创客按物料清单买元件，用 3D 打印机复刻自己的桌面机器人。
- 嵌入式学习者研究 ESP32 固件中舵机动画与表情的实现。
- 团队把机器人接入自研智能体流水线作物理指示灯。
技术栈与运行环境
固件为 C++ Arduino 框架基于 PlatformIO 构建，pio run 编译，pio run -t upload 刷固件与 LittleFS 文件系统，串口波特率 115200。
硬件物料含 Waveshare ESP32-C3-Zero 主控、PCA9685 驱动、五颗 SG90 舵机、SSD1306 OLED 屏、MAX98357A 功放加喇叭，供电 5V 2A 以上。
功能亮点
- AI 编程智能体读文件、思考、写代码、完工四类事件全程实体化演示。
- REST API 一个 POST 请求即可触发十余种动画动作。
- Cursor 与 Antigravity CLI 官方集成，Claude、Codex 等按文档自行接入。
- 首次开机 AP 配网向导，OLED 逐步显示联网步骤。
- Web 管理界面提供设置、硬件自检与动画测试。
- 完整文档链覆盖元件清单、接线图、参数化 CAD 与舵机行程。
技术架构与部署指南
安装与部署提示
按元件清单采购硬件并 3D 打印外壳，装好五个舵机后按文档连 I2C 与 I2S 总线。
项目根目录执行 pio run -t upload 刷入固件与文件系统，若舵机动而无声需补跑 uploadfs。
首次上电连 TinyEngineer 热点，浏览器打开 192.168.4.1/config 完成舵机校准与 2.4G Wi-Fi 配置。
浏览器访问 tiny-engineer.local 进 Web 界面，curl POST anim 接口即可测试动作，最后把 Cursor 钩子或自研脚本指向机器人地址。
截图与演示说明
上图来自项目 README 的官方预览图，红黑配色的小机器人坐在工位上对着迷你笔记本敲码，造型与项目气质一致。
架构图来自 README 的 how-it-works 节，绘制了智能体事件到 REST 接口再到舵机屏幕喇叭三层硬件的数据流。
README 顶部附 YouTube 演示视频与动图预览，仓库 issues 区欢迎提交新集成方案。
常见问题
问. Tiny Engineer 是什么项目？
Tiny Engineer 是开源 3D 打印桌面机器人源码，ESP32-C3 加五个舵机驱动，AI 编程智能体读码思考敲码时机器人同步做动作，通过 REST API 可对接 Cursor 等任意智能体。
问. Tiny Engineer 源码怎么编译烧录？
固件为 PlatformIO 工程，执行 pio run 编译，pio run -t upload 刷固件与文件系统，无声时补跑 uploadfs，首次开机走 AP 配网向导。
问. 和普通桌面时钟对比有什么区别？
与翻页时钟类产品对比，Tiny Engineer 由智能体事件驱动五舵机拟人动作与表情音效，固件 MIT 开源可改 CAD 动画，普通时钟仅显示固定信息且多闭源。
问. Tiny Engineer 可以商用吗？
软件固件部分 MIT 协议可商用，3D 打印模型与电路板等硬件设计 CERN-OHL-S-2.0 需遵循同源分发条款，项目名称与标识不在授权范围不可商用。
安全风险提示
对仓库 459 个源码文件做了高风险函数扫描，未发现 eval、exec、远程脚本执行与硬编码密钥，固件仅监听局域网。
机器人 REST 接口无鉴权，请仅在家庭或办公内网使用，避免暴露公网；软件与硬件分别遵循 MIT 与 CERN-OHL-S-2.0 条款。
下载说明
本页提供 Tiny Engineer 桌面机器人的完整源码打包下载，含 ESP32 固件、集成脚本、3D 打印模型与全套硬件文档。
压缩包为原始仓库文件，解压后按部署提示准备 PlatformIO 环境即可编译烧录。
GitHub项目开源地址 https://github.com/jamro/tiny-engineer
