AgentMeshOS 是面向个人和小团队的自托管 AI Agent 运行时平台。它将分散的计算节点、模型能力、任务调度、系统云盘和应用交付物组织成可追溯的工作链。
项目类型: 分布式平台
开发周期: 2025 年 7 月 - 至今
团队规模: 个人项目
项目状态: 生产环境
- 多节点协作: 统一管理多台服务器上的 AI 工作负载
- 成果可追溯: 所有任务、交付物、证据可审计
- 应用交付: 统一的应用注册、执行和交付机制
- 节点能力匹配和选择
- 任务取消、恢复和审计
- 自然语言需求描述
- 自动生成任务依赖图
- 文件级 SHA-256 追溯
- 版本控制和回滚
- 应用注册和生命周期管理
- 标准化输入输出接口
- 自动成果归档
| 组件 | 技术栈 | 职责 |
|---|---|---|
| AI Runtime | FastAPI + SQLite | 任务编排、状态管理、应用生命周期 |
| Console | Vanilla JS | Web 管理界面 |
| OmniRoute | 官方 | 模型路由和健康检查 |
| Nomad | HashiCorp | 分布式任务调度 |
| Cloudreve | Go | 系统云盘和文件存储 |
| Tailscale | Tailnet | 节点控制面网络 |
用户请求 → Console
↓
AI Runtime(规划、任务图)
↓
Nomad(节点选择、调度)
↓
Worker(执行)
↓
Cloudreve(成果存储)
↓
AI Runtime(验收、审计)
↓
Console(展示)
- 模型只能调用已注册能力
- 任务沙箱和隔离
- 所有成果记录 SHA-256
- 完整审计日志
- ✅ 支持 3 个生产节点协作
- ✅ 管理 20+ 注册应用
- ✅ 处理 500+ 任务
- ✅ 零数据丢失,100% 可追溯
后端:
前端:
基础设施:
存储:
- 单用户场景不需要复杂数据库
- FTS5 提供强大的全文搜索
- 备份简单 - 直接文件级拷贝
- 当前单用户规模不需要
- 保持系统简单可控
AgentMeshOS/
├── ai-runtime/ # AI Runtime 服务、存储、应用、测试
├── tools/ # Console、Docs、Gateway、Worker 组件
├── scripts/clients/ # 节点入驻和客户端脚本
├── scripts/deploy/ # 服务和容器部署脚本
├── scripts/ci/ # 本地测试、计划状态、发布检查
├── docs/architecture/ # 架构、部署、安全(权威文档)
├── docs/plans/ # 当前计划、历史、完成归档
├── nomad/ # Nomad 任务定义和 fixtures
└── AGENTS.md # 协作者和 AI 执行入口
这是一个生产系统,展示了分布式平台架构和 AI 编排能力。