Limioryn：开源端云硬件AI智能体框架

Limioryn是什么

Limioryn是基于Python与C语言开发，遵循Apache 2.0开源协议的端侧硬件+云端AI智能体开源Agent开发框架，专门面向物联网、边缘硬件自动化场景。它解决传统大模型智能体只做软件逻辑，缺少真实硬件状态闭环校验、多智能体硬件操作冲突、AI盲目下发危险设备指令的行业痛点。

该框架打通本地规则逻辑、边缘硬件设备、云端大模型，开发者可以使用声明式的极简代码，搭建具备物理设备闭环能力的AI智能体，既可以快速完成原型Demo验证，也能够向工业级7×24小时持续运行的工程系统演进。项目当前处于预览版本，底层包含C语言高性能运行时，支持多种单片机、单板机硬件接入，内置Web可视化调试面板。

功能特色

1. 端云同构统一API
   本地静态规则和云端LLM大模型使用同一套设备抽象接口，切换运行模式不需要重写业务代码，支持本地规则、云端大模型、端云混合三种工作模式。

2. 物理硬件闭环状态追踪
   区别普通Agent工具调用仅返回逻辑成功，完整记录硬件动作全生命周期：消息接收、执行中、执行完成、等待硬件回执，每一步进行状态对账校验，确认设备真实执行结果。

3. 分层多智能体协作与冲突防护
   支持操作员Agent与安全复核Agent的监督式团队架构；内置硬件互斥锁，多个智能体无法同时操控同一个执行器件，规避硬件操作冲突。

4. 熵约束安全执行机制
   引入熵预算、证据等级约束设备动作。当采集信息不足时，状态标记为UNKNOWN，会主动采集补充数据或者直接拒绝执行，避免大模型编造虚假指令驱动硬件。

5. 持久化隔离工作空间Workspace
   提供隔离的长期任务运行环境，实现租户、设备、智能体身份隔离，记忆持久化、任务归档、受控文件读写，适配长时间不间断自动化任务。

6. 内置Web可视化调试面板
   本地部署后可访问Web界面，支持拖拽模拟传感器数据，可视化调试设备与智能体交互逻辑，快速验证业务原型。

7. 硬件中立，多硬件兼容
   框架不绑定特定MCU芯片、消息队列、云厂商，提供ESP32‑S3、STM32、Linux单板机三类硬件参考工程，其他嵌入式硬件可基于协议移植适配。

技术细节

• 编程语言：主体业务逻辑Python（92.1%），底层高性能运行时C语言（7.8%），剩余为配置与脚本文件。

• 开源协议：Apache 2.0。

• 版本现状：预览版0.39.0，存在持续迭代更新。

• 运行环境要求：Python3.11及以上，支持Windows开发环境；硬件侧支持ESP32‑S3、STM32单片机、树莓派类Linux边缘网关。

• 通信层：以MQTT作为硬件通信参考实现，通信协议可自定义替换。

• 安全机制：设备能力白名单、角色权限隔离、输入值域限制、执行冲突自动检测；提供安全Agent复核链路。

• 运行模式

1. 本地规则模式：不依赖大模型，纯代码规则驱动硬件；

2. LLM云端模式：对接通义千问等大模型API，由大模型生成控制逻辑；

3. 混合模式：本地规则做安全兜底，大模型负责业务决策。

• 执行链路：传感器环境采集 → Agent决策判断 → 下发硬件工具指令 → 设备执行 → 设备状态回执对账。

应用场景

1. 智慧农业温室自动化：采集温湿度传感器，AI智能体自动控制继电器、通风、灌溉设备，实现温室闭环自动调控。

2. 嵌入式物联网AI原型开发：ESP32等单片机快速接入AI Agent，快速验证硬件智能控制原型。

3. 边缘网关智能调度：树莓派等边缘设备，运行7×24小时智能运维任务，管理多组传感器与执行器件。

4. 小型工业设备自动化：非安全关键型工业小设备，实现端‑云结合的智能控制，做设备状态监控与自动处置。

5. 教学科研实验：用于AI Agent结合实体硬件的科研、课程原型搭建。

重要提示：项目为开发框架，不能替代工业功能安全认证、硬件急停、看门狗等安全硬件机制，涉及人身财产安全场景需要额外独立风险评估。

使用方法

方式一：PyPI快速安装

适合快速体验Demo，可按需安装MQTT、Redis等扩展依赖，安装完成后可以直接校验框架版本，快速运行官方示例代码。

方式二：源码本地部署开发

1. 克隆GitHub仓库到本地开发环境；

2. 使用可编辑模式本地安装项目依赖；

3. 运行示例Demo，启动本地Web服务，访问地址127.0.0.1:8765打开可视化调试面板；

4. 编写声明式代码，定义传感器、执行器以及业务控制逻辑；

5. 对接真实硬件：使用官方硬件参考工程烧录固件，设备通过MQTT接入框架；

6. 可选配置大模型API密钥，切换为LLM驱动模式；

7. 业务验证完成后，创建Workspace工作空间，部署长期持续运行的自动化任务。

竞品对比

常见问题解答

Limioryn可以直接用于生产环境的工业安全设备吗？

不可以。该项目目前为预览版本，它只是开发框架，不替代工业安全认证、硬件急停、硬件看门狗等安全机制。如果用于涉及人身、财产风险的场景，必须自行完成独立风险评估与安全加固。

Limioryn必须搭配大模型才能运行吗？

不是。框架支持纯本地规则模式，不需要调用任何大模型API，完全依靠代码规则实现硬件控制；大模型属于可选的能力扩展。

支持哪些硬件，普通单片机可以移植吗？

官方提供ESP32‑S3、STM32、Linux单板机三套参考工程。框架硬件中立，只要可以实现对应通信协议，其他单片机可以自行移植适配。

Web面板必须部署才能使用框架吗？

Web可视化面板是调试原型工具，正式长期任务可以不启动Web服务，直接使用Workspace接口运行后台自动化任务。

可以更换MQTT为其他消息中间件吗？

可以，MQTT仅为官方参考通信实现，协议层可以替换为其他消息组件。

相关链接

• 项目GitHub仓库：https://github.com/YINGLINGH/limioryn

总结

Limioryn是一款面向实体硬件场景的开源AI智能体开发框架，补齐了传统大模型Agent缺少真实硬件状态校验、硬件操作冲突管控的短板，依靠端云同构API、熵约束安全机制、多智能体协作能力，帮助开发者快速把AI智能体和物联网硬件结合，兼顾原型快速验证与长时间运行任务的开发需求，适合物联网自动化、边缘智能相关原型与工程开发。