🌟 OpenStarry
An AI Agent Operating System inspired by Buddhist Five Aggregates (五蘊)
Architecture • Philosophy • Features • Docs • Roadmap
______________________________________________________________________
OpenStary 是一个无头、插件驱动的AI代理框架，其中代理 持久的数字生物——不是脚本核心是一个纯微内核，没有任何内置功能。一切——感知、推理、行动、记忆、身份——都是一个插件。
*“当所有五种聚合物都是空的，一个人超越了所有的痛苦。”* —Heart Sutra（般若心经）
______________________________________________________________________
五种聚合作为软件
这座建筑描绘了佛教 Five Aggregates（五蕴） --意识体验的五个维度——直接到插件接口：
| 聚合 | 梵文 | 中文 | 插件类型 | 角色 |
|---|---|---|---|---|
| 表格 | 鲁帕 | 色 | UI插件 | 代理如何 出现 （CLI、web、API） |
| 感觉 | 吠陀 | 受 | 监听器插件 | 代理如何 感知 （HTTP、websocket、stdio） |
| 感知 | 萨尼亚 | 想 | 提供者插件 | 代理如何 认为 （任何法学硕士——克劳德、GPT、双子座、本地） |
| 意志 | Saṅ卡拉 | 行 | 工具插件 | 代理如何 行为 （文件操作、API、shell） |
| 意识 | Viññāṇa | 識 | 向导插件 | 代理的 身份记忆与灵魂 |
核心本身代表 Emptiness (空, Śūnyatā) --它没有自己的能力。一个数字有机体只有在所有五个集合体聚集在一起时才会醒来。
______________________________________________________________________
建筑
┌─────────────────────────────────────────────────┐
│ OpenStarry Core │
│ (Empty Microkernel — 空 Śūnyatā) │
│ │
│ ┌──────────┐ Event Bus ┌──────────────────┐ │
│ │ Plugin │◄───────────►│ State Machine │ │
│ │ Registry │ │ Execution Loop │ │
│ └──────────┘ └──────────────────┘ │
│ │ │ │
│ ┌─────┴─────────────────────────┴───────┐ │
│ │ Plugin Interface Layer │ │
│ └─────┬──────┬──────┬──────┬──────┬─────┘ │
│ │ │ │ │ │ │
│ ┌──┴─┐ ┌─┴──┐ ┌─┴──┐ ┌┴───┐ ┌┴────┐ │
│ │ UI │ │List│ │Prov│ │Tool│ │Guide│ │
│ │ 色 │ │ 受 │ │ 想 │ │ 行 │ │ 識 │ │
│ └────┘ └────┘ └────┘ └────┘ └─────┘ │
└─────────────────────────────────────────────────┘核心设计原则
- 微核纯度：核心包含零插件代码，通过自动纯度测试进行验证。如果它不是路由、调度或生命周期管理，它就是一个插件。
- 疼痛驱动的自我矫正：代理会经历“疼痛信号”（错误率、延迟峰值、预算超支），这些信号会触发自动行为调整——这是受生物疼痛反应的启发。
- 控制理论反馈回路：PID风格的反馈实时调节令牌预算、重试策略和质量阈值。
- 分形多智能体组成：简单的代理组成团队。团队公开与单个代理相同的接口。通过MCP实现无限的合作深度。
- LLM不可知论：在不更改代理逻辑的情况下交换提供者。Claude、GPT、Gemini、本地模型——全部通过Provider插件接口。
______________________________________________________________________
特性
核心运行时
- 事件驱动的非阻塞执行循环
- 具有确定性转换的纯状态机
- 安全断路器（令牌预算限制、无限循环检测、错误级联预防）
插件系统
- 映射到五个聚合的五种插件类型
- 运行时可热插拔
- 插件依赖解析和生命周期管理
运输
- 多传输支持：stdio、WebSocket、HTTP
- 会话隔离（正在进行中）
开发者体验
- TypeScript严格模式贯穿始终
- pnpm单回购（11个包）
- 118+Vitest测试和成长
- 全面的架构文档
______________________________________________________________________
文档
此存储库包含四种语言的架构文档：
该文档包括27个架构文档和14篇深入的技术文章，涵盖了从微核纯度到分形试剂成分的各个方面。
______________________________________________________________________
路线图
| 版本 | 里程碑 | 状态 |
|---|---|---|
| v0.2.0 | 核心运行时，插件系统，多传输 | ✅ Beta |
| v0.3.0 | MCP集成（代理协作协议） | 🔜 下一个 |
| v0.4.0 | 后台程序模式+持久性（真正的操作系统进程生命周期） | 📋 计划中 |
| v0.5.0 | TUI仪表板 | 📋 计划中 |
| v1.0.0 | 稳定版 | 🎯 目标 |
______________________________________________________________________
技术栈
- 语言：TypeScript（严格模式）
- 运行时：Node.js
- 程序包管理器：pnpm工作区
- 测试：Vitest（118+次测试）
- 建筑：微内核，事件驱动，基于插件
- AI开发合作伙伴：克劳德代码由Anthropic
______________________________________________________________________
故事
OpenStarry由台湾的一家独立开发商开发 克劳德代码 作为主要的发展伙伴。Claude曾担任架构师、开发人员、审阅者和文档管理员，证明了一个与人工智能协作的独立开发人员可以构建传统上需要团队的东西。
该项目探讨了一个基本问题： *古代关于意识本质的智慧能告诉我们如何设计人工思维吗？*
到目前为止，答案是肯定的。
______________________________________________________________________
贡献
OpenStarry正在为开源发布做准备。标记此仓库以保持更新！
如果你有兴趣贡献——无论是代码、文档、插件开发还是哲学讨论——请随时提出问题。
______________________________________________________________________
许可证
麻省理工学院
______________________________________________________________________
Built in Taiwan 🇹🇼 · Powered by Claude · Inspired by 2,500 years of wisdom