Metadata-Version: 2.4
Name: limioryn
Version: 0.39.0
Summary: High-level API and runtime for edge-cloud AI multi-agent systems and real IoT devices
Author: Xuchen Zhang
License-Expression: Apache-2.0
Project-URL: Homepage, https://github.com/YINGLINGH/limioryn
Project-URL: Documentation, https://github.com/YINGLINGH/limioryn/tree/main/docs
Project-URL: Repository, https://github.com/YINGLINGH/limioryn
Project-URL: Issues, https://github.com/YINGLINGH/limioryn/issues
Keywords: agent-framework,edge-cloud,iot,multi-agent,physical-ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.11
Classifier: Programming Language :: Python :: 3.12
Classifier: Topic :: Scientific/Engineering :: Artificial Intelligence
Classifier: Topic :: Software Development :: Libraries :: Application Frameworks
Classifier: Topic :: System :: Distributed Computing
Requires-Python: >=3.11
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: NOTICE
License-File: AUTHORS.md
Provides-Extra: cli
Requires-Dist: typer>=0.12; extra == "cli"
Requires-Dist: rich>=13; extra == "cli"
Provides-Extra: langgraph
Requires-Dist: langgraph<2,>=1.1; extra == "langgraph"
Provides-Extra: postgres
Provides-Extra: redis
Requires-Dist: redis<6,>=5; extra == "redis"
Provides-Extra: sentinel-security
Requires-Dist: redis<6,>=5; extra == "sentinel-security"
Requires-Dist: cryptography>=42; extra == "sentinel-security"
Provides-Extra: schema
Requires-Dist: jsonschema>=4.21; extra == "schema"
Provides-Extra: observability
Requires-Dist: opentelemetry-api>=1.25; extra == "observability"
Provides-Extra: gateway
Requires-Dist: uvicorn>=0.30; extra == "gateway"
Provides-Extra: identity
Requires-Dist: cryptography>=42; extra == "identity"
Provides-Extra: http2
Requires-Dist: httpx[http2]<1,>=0.27; extra == "http2"
Provides-Extra: mqtt
Requires-Dist: paho-mqtt<3,>=2.1; extra == "mqtt"
Provides-Extra: dev
Dynamic: license-file

# Limioryn

Limioryn 是面向端云协同 AI、多 Agent 与真实设备接入的分层 Python API。它统一设备 Capability、多 Agent 协作、受约束物理执行、状态确认与恢复，帮助开发者把智能应用构想落地为可连接真实设备、可验证、可恢复的工程系统。

> 当前版本：`0.39.0`。项目处于公开预览阶段。涉及人身、财产或工业安全的系统，仍需独立风险评估、硬件联锁和现场验证。

## 安装

```bash
python -m pip install limioryn
```

Python 版本要求：3.11 或更高版本。

按需安装可选能力：

```bash
python -m pip install "limioryn[cli,mqtt]"
python -m pip install "limioryn[redis,sentinel-security]"
python -m pip install "limioryn[langgraph]"
```

## 几行代码建立概念化场景

```python
from limioryn import create_demo

system = create_demo("智慧温室")
soil = system.sensor(
    "soil", capability="sensor.moisture", initial=55, unit="%",
)
pump = system.actuator("pump", capability="actuator.relay")

system.agent(lambda soil: pump.on() if soil < 30 else pump.off())
system.scene("干燥", soil=22)
system.scene("湿润", soil=80)
system.run()
```

默认模式不需要模型密钥。开发者也可以在同一设备合同上接入云端模型、多 Agent Team、Runtime、Device SDK 和长期 Agent Workspace。

## 四层能力

- **Demo Builder**：用少量声明生成业务场景、交互控制台和状态投影。
- **Framework**：定义 Agent Team、Capability 权限、验证者和执行策略。
- **Runtime**：处理命令白名单、风险边界、Outbox、ACK、对账与恢复。
- **Harness / Device SDK**：验证设备协议合同，并提供 ESP32-S3、STM32 与 Linux SBC 参考实现。

Limioryn 的熵模型用于约束可能产生不可逆物理后果的执行。模型评分不能绕过 Capability、Schema、权限、命令白名单或硬件联锁。

## 发布与来源说明

代码采用 Apache-2.0 许可证，原始作者为 Xuchen Zhang。项目不会设置打赏渠道；欢迎体验、[提交问题](https://github.com/YINGLINGH/limioryn/issues)和参与开发。如果它对你有帮助，也欢迎在 [GitHub](https://github.com/YINGLINGH/limioryn) 上点一个免费的 Star。
