vstorm-co/agenticos
AI 工程面向企业团队的自托管 AI 智能体平台,可构建、发布并治理智能体,内置共享聊天、RAG、工具与预算控制。
项目介绍
AgenticOS 是一个采用 Apache-2.0 许可、可自托管的智能体平台,目标是在公司内部构建、共享和治理 AI 智能体。团队在浏览器里编写智能体指令、选择模型、开启工具,再发布到网页聊天、Slack、Teams、Discord、Mattermost、Telegram、网站挂件、托管页面、HTTP API 或 WebSocket。管理员可以设置角色与部门分组、智能体与组织级月度预算、敏感工具的审批策略,每次运行都会写入按组织哈希链式串联的审计日志。
它的设计把「代码定义、配置组装」分开:工程师用带类型的 Python 注册能力,非开发者只从已注册的能力里组装智能体。技术栈为 FastAPI、Pydantic AI、PostgreSQL + pgvector、Redis 和 Next.js 架构说明。RAG 的做法是把上传或同步的文档解析、切块、嵌入后存入 pgvector,回答时带引用;也可以使用本地解析器和 Ollama 嵌入模型做全本地部署。
快速使用
开发者最快的路径是 Docker Compose 加一个模型提供方。在 macOS 或 Linux 上运行:
curl -fsSL https://raw.githubusercontent.com/vstorm-co/agenticos/main/scripts/quickstart.sh | bash
Windows 需要在开启 Docker Desktop WSL2 集成的 WSL2 中执行同一命令。安装脚本会询问模型提供方与密钥、登录账号和组织名称,拉取已发布镜像并启动部署,文档给出的最低配置是 4 vCPU 和 8 GB 内存;完成后打开 http://localhost:3000,用安装时设置的账号登录 本地快速开始。执行前可以先阅读安装脚本,或用 --check 只检查前置条件而不安装 quickstart 脚本。
登录后可按首个文档智能体教程上传手册、提问并对照引用来源核对回答 文档智能体教程。
其他入口:桌面应用可连接已有工作区,不需要本地 Docker 桌面端说明;IT 可从固定版本部署公司服务器并初始化首个组织 部署指南;还有 RepoCloud 与 Railway 的一键模板,不过 Railway 模板固定的是较旧版本,且没有本地代码沙箱。
使用约束
- 部署环境:受支持的生产部署是单台 Linux 主机上的 Docker Compose,需要 4 vCPU、8 GB 内存、Docker Engine 24+、Compose 2.24+ 和
make;十人团队建议两个 API worker。 - 运维责任:自托管需要有人负责更新、备份、访问控制和外部服务。备份必须同时包含数据库和
backend/.env中的 vault 密钥。 - 模型:文档列出 28 个模型提供方,包括托管 API、通过云合同使用的 Azure/Bedrock/Vertex、通过 Codex 使用 ChatGPT 订阅,以及 Ollama、LiteLLM、vLLM、LM Studio 等本地部署。
- 身份认证:支持邮箱密码与魔法链接、Google、OIDC(Entra ID、Okta、Keycloak 等)、LDAP 和 Kerberos。多因素认证依赖身份提供方,暂无原生 MFA、SAML 和 SCIM 权限说明。
- 数据边界:源系统的权限不会自动映射,智能体可能把它绑定的知识开放给使用者。自托管控制台并不等于所有模型、解析器和工具都在本地,需要逐个检查对外目标 安全说明。
- 移动端:手机浏览器可用,但原生 iOS/Android 应用目前是开发构建,没有应用商店发布版本。
HotRepo 点评
仓库创建于 2026 年 7 月底,2026-11-16 记录到 345 个 Star、58 个 Fork,当天在 Python 日榜新增 56 个 Star,最高排到第 12 名。这只是单日数据,说明出现了一波关注,而不是持续趋势,且在全语言日榜上没有记录到名次。
与多数智能体框架相比,它的覆盖面更完整:聊天渠道、MCP 目录、预算检查、审批和审计日志都在同一个服务里,README 也明确写出了尚未覆盖的部分,例如权限映射和原生 MFA。对于已经在运行 Python 与 PostgreSQL 基础设施的团队,Docker Compose 上手路径和文档化的能力扩展方式让这些取舍比较容易评估。
本文由 AI 根据项目 README 生成,更新于 ,以项目官方文档为准。
Hacker News 讨论
相关推荐
- agentes-chat/agentes-chat自托管团队聊天工具,让人和 AI 代理在频道、私信里协作并审批敏感操作。
- paperclipai/paperclip把多个异构编程 Agent 当成一家公司来管:目标、组织架构、预算和审计都在一个面板里。
- ahmadrosid/nakama面向团队的可自托管 AI Agent 平台,支持多组织、角色权限、工具、记忆和消息渠道,让成员共享和使用智能体。
- Shubhamsaboo/awesome-llm-apps面向开发者的 AI Agent、RAG 与 Agent Skill 示例合集,每个模板都能直接跑起来。
- mcpjungle/MCPJungle自托管的 MCP 网关:注册一次服务器,即可让各类 AI 客户端和 Agent 通过单一端点访问其工具。