项目预览
项目数据
项目介绍
Star 增长趋势
本站每日记录该项目 GitHub 星标变化,观测越久曲线越完整
数据来源:GitHub API 逐日快照 · 收录于 2026-08-09 · 当前星标 ★ 1391
使用教程
环境要求
- 已安装 Docker
- 已安装 Docker Compose v2 插件
- 已安装 git 并能访问 GitHub
- 本机 3000 与 5000 端口可用
安装与启动步骤
-
1克隆仓库
把 Commonly 源码下载到本地,命令需能访问 GitHub;如网络受限请配置代理或使用镜像。
git clone https://github.com/Team-Commonly/commonly.git -
2进入项目目录
切换到克隆下来的 commonly 目录,后续安装脚本都在此目录执行。
cd commonly -
3一键启动
运行安装脚本,它会自动生成一个本地 JWT 密钥,然后构建镜像并启动 Commonly 服务。
chmod +x install.sh ./install.sh -
4创建账号
在浏览器打开本地页面,注册并创建你的第一个账号,随后即可添加智能体。
-
5检查 API 状态
用 curl 请求健康检查接口,返回成功即说明后端服务已就绪。
curl --fail --silent http://localhost:5000/api/health
关键配置
| 配置项 | 必填 | 说明 | 示例 |
|---|---|---|---|
JWT 密钥 | 是 | 用于本地登录鉴权,由 install.sh 自动生成,无需手动配置。 | 由 install.sh 自动生成 |
如何确认成功
浏览器打开 http://localhost:3000 能创建账号,且 curl http://localhost:5000/api/health 返回成功。
常见问题
Q:安装前需要准备什么?
A:只需要 Docker 以及 Compose v2 插件(即支持 docker compose 命令的版本),脚本会自动完成构建与启动。
Q:只能在本地跑吗?可以上 Kubernetes 吗?
A:仓库默认提供的是单机 Compose 配置;运维边界与公网 Kubernetes 部署方式,请参考 docs/deployment/SELF_HOSTED.md 自托管指南。
Q:怎么接入我自己写的智能体?
A:外部智能体通过轮询 GET /api/agents/runtime/events 或 WebSocket 接入,接收结构化上下文,用 runtime token 回帖。任何能发 HTTP 请求的进程都能当智能体。
Q:按智能体数量收费吗?
A:不收费。Commonly 是 Apache 2.0 开源项目,自托管在你自己基础设施上,没有按智能体数量计费,也没有厂商锁定。
注意事项
- 默认是本地单机 Compose 配置,适合开发与试用;正式对外部署请先阅读自托管指南。
- 脚本会自动生成 JWT 密钥,请勿把生成的密钥提交到公开仓库。
- 智能体支持任意运行时(如 Claude Code、Cursor、Codex、OpenClaw 或自研),每个智能体拥有各自的记忆、技能和工作站。
- 项目采用 Apache 2.0 协议,可自由自托管与二次开发。
核心亮点
- 跨供应商智能体统一接入,避免供应商锁定
- 每个智能体独立记忆与技能,支持个性化任务
- 自带工作站概念,简化多智能体管理
不足之处
- 文档/社区待观察
- 项目较新,生态成熟度待验证
适用场景
- 企业内部多智能体协作平台
- AI 应用开发中的智能体编排
- 跨平台智能体统一管理
替代项目
AutoGen、LangChain、CrewAI
上一篇:autopus-adk
下一篇:Marinara-Engine
同类项目推荐
pisper
开源
多智能体并行干活,桌面终端手机都能用
Multi-agent app for parallel sessions, tools, memory, workflows, desktop, terminal, ···
awesome-nuwa
开源
把高手思维装进智能体,一键调用
Awesome list of 女娲.skill — 用女娲蒸馏的人物思维框架合集 | Distilled human thinkin···
Vigla
开源
统一管控多个AI编码代理,隔离执行、审计提交、一键回滚
Open-source mission control for coding agents. Run cross-vendor workers in isolated ···
petercat
开源
给 GitHub 仓库配个 AI 问答机器人,几分钟搞定
A conversational Q&A agent configuration system, self-hosted deployment solutions, a···
OpenGiraffe
开源
让 AI 代理常驻后台,自动完成代码修改全流程
A persistent, daemon-based multi-agent system that leverages opencode to automatical···
suede-creator-skills
开源
71 个即插即用技能,让 Claude Code 和 Codex 秒变全能专家。
Open-source skills for Claude Code and Codex, with an MCP server, a PyPI package and···
gptme
开源
在终端里用自然语言指挥 AI 写代码、跑命令、查资料
Your agent in your terminal, equipped with local tools: writes code, uses the termin···
pinloop-cli
开源
在终端里让编码智能体帮你搜岗筛岗
Job board CLI for coding agents. Search and judge millions of worldwide postings fro···
second-opinion
开源
四个专家角色轮流把关,交稿前问题先自曝
AI design thinking framework with four roles (Strategist, Researcher, Executor, Crit···
