AI协同操作系统

SynapseOS是一个本地优先、高度可扩展的后端引擎,支持多个AI代理并行执行协调任务,适用于智能工作空间自动化。

  • by hanzlikhan
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 hanzlikhan/SynapseOs

使用说明

AI SynapseOS

智能工作空间的人工智能操作系统

SynapseOS是下一代本地优先、高度可扩展的后端引擎,使多个AI代理能够同时执行协调的任务。利用统一的事件网格(MCP over Redis),复杂的推理循环可以动态地适应传入的Webhook、自然语言工作流和深度知识图查询。把它想象成Zapier,但模块实际上是独立思考的。


🔥 主要特征和功能

  • 模型上下文协议(MCP)基础:类似微服务的AI工具功能隔离。代理直接与标准功能自主交互。
  • 自主工作流React Flow可视化构建器将自然语言(通过Gemini)转换为严格的执行节点(“如果发票>10天→ 通往财务代理的路线”)。
  • 代理智能网格:通过计划-执行-验证推理循环执行的专业内部代理(财务、支持、销售)。
  • 矢量RAG知识库:集成文档矢量化,允许代理即时调用自定义工作区文件,并为人类提供高级Omnisearch索引。
  • 企业循环人(HITL):未达到75%置信阈值的操作验证会自动停止,在RBAC角色验证的审批队列中排队。
  • 实时活动Websockets:与Redis Pub/Sub的深度集成提供了对流入统一执行仪表板UI的代理工作流的亚秒级延迟跟踪。

🏗 架构说明

技术栈:

  • 后端核心:FastAPI(Python)、SQLAlchemy异步、Pydantic、Uvicorn/Gunicorn。
  • 前端仪表板Next.js 14、React、Zustand、React Flow、TailwindCSS、Shadcn/ui。
  • 数据库和状态:PostgreSQL(w/ pgvector 用于嵌入)、Redis(用于Streams/PubSub)。
  • 人工智能: google-generativeai (双子座1.5)。

真正的魔法发生在事件引擎中。 mcp/router.py 拦截传入的Webhook,根据工作流编译器实例化的动态规则对其进行验证,并将原始执行计划分配给本地化的专用代理。


🚀 本地快速入门(Docker)

git clone https://github.com/mh-hanzla/SynapseOS.git
cd SynapseOS
# Configure Environment
cp .env.example .env

# Boot the isolated containers
docker-compose up --build

导航至 http://localhost:3000 查看Executive edge。FastAPI Swagger文档可在 http://localhost:8000/docs.


🌐 生产部署

SynapseOS MVP是完全容器化的,为高可用边缘PaaS解决方案做好了生产准备。 查看综合 部署指导 编排健壮的堆栈:


🛡️ 审计与安全

所有外部突变都是被迫通过的 PerformanceAndAuditMiddleware 记录高保真不可变性轨迹。应用程序范围的路由限制会立即删除未经身份验证的异常。所有秘密都严格限于CI/CD库注入。


作为投资组合的顶点构建|2026