somora
在自己的机器上运行可共享长期记忆、自由切换模型的个人 AI 团队。
- Star 数
- ★ 35
- 最近更新
- 4 天前
- License
- MIT
- 主语言
- TypeScript
- FA 评分
- 58/100 · 缺口较多
30 秒速览
- 运行形态
- 可在哪里用
- 通用 · 跨平台ChatGPT · Codex · Claude Code
- 费用
- 免费,无需付费服务
- 上手难度
- 低 · 几分钟可跑通
- 开始前需要
- 典型场景
- 希望在个人电脑上同时管理研究、协调和执行角色,并让它们互相委派任务的个人用户。
- 不适合
- 需要原生 Windows 安装路径的用户
- 不愿运行本地后台服务的团队
- 要求生产稳定版而非活跃开发项目的组织
- 官网
- somora.ai ↗ 来自 GitHub 仓库设置
- 维护状态
- 近 30 天有提交最近提交 2026-11-16最新版本 v2026.1116.11(2026-11-16)
- 源码审查
- 58/100 · 缺口较多
这个 Agent 能做什么,适合哪些场景?
somora 是一个运行在用户机器上的多智能体服务器,提供终端 TUI、浏览器桌面和移动 PWA 三种客户端。每个聊天智能体拥有独立角色、私有记忆、模型偏好和工具权限,同时可通过 Obsidian wiki 共享经过 dream 周期整理的长期知识。系统可在同一会话中切换 Claude、ChatGPT、Grok 和 OpenAI-compatible 后端,并让历史记录及工具继续沿用。它还提供专门面向代码仓库的 builder 智能体,以及文件、shell、tmux、网页、附件、子智能体、定时触发器、浏览器和外部 MCP 等工具。配置、会话、附件和智能体记忆默认位于 ~/.somora/,共享 wiki 位于用户指定的 Obsidian vault,因此部署边界由用户自己的机器和所配置的外部服务决定。
用户从 somora tui、Web 客户端或移动 PWA 发起请求后,somora-server 将其放入对应会话的单一队列;来自其他智能体、子智能体、Sentinel 定时器或语音通话的任务也走同一调度路径。执行层可调用 claude-cli、codex-cli、grok-cli 或 openai-compatible 引擎,并通过统一工具注册表访问 memory、dream、wiki、file、exec、tmux、web、agents、skills、sentinel、browser、media、projects 和外部 MCP 工具。聊天过程中发现的事实可写入智能体私有 Markdown 记忆;REM、Deep 和 Lucid 三阶段 dream 流程分别把会话整理为记忆、把稳定记忆提升到共享 wiki,并复核 wiki。检索使用 SQLite、sqlite-vec 与 FTS5,为私有记忆、共享 wiki 和只读 vault 内容维护独立索引。对于软件开发,kind: builder 的智能体在固定项目目录中规划、编辑、运行和测试代码;它可读取记忆,但不会写入记忆或参与 dream。
- 希望在个人电脑上同时管理研究、协调和执行角色,并让它们互相委派任务的个人用户。
- 已经使用 Claude、ChatGPT、Grok 或本地模型,希望在同一会话中切换后端而不丢失历史和工具上下文的用户。
- 使用 Obsidian 管理知识,希望把聊天中反复出现的稳定信息沉淀为共享 wiki 的知识工作者。
- 需要把定时任务、浏览器操作、文件处理、shell 和 tmux 会话统一交给一组智能体的高级用户。
- 希望为代码仓库配置长期运行的 builder,同时保留普通聊天智能体负责沟通和任务交接的开发者。
- 希望从终端、桌面浏览器和手机访问同一套本地智能体、会话与记忆的用户。
安装与配置要点
摘自下方的安装和使用说明,以项目 README 的最新说明为准。
- 安装 / 启动命令
curl -fsSL https://somora.ai/install.sh | bashnpm install -g somora && somora setupcurl -fsSL https://claude.ai/install.sh | bash && claude auth login
- 配置文件
~/.somora/config.yaml- 运行环境
- Node.js 22.13+
- 安装说明涉及
- macOS · Linux
如何安装或部署这个 Agent?
支持 Linux 或 macOS,并要求至少一个可用的 LLM 后端。推荐以普通用户身份运行安装器;它会检查所需工具、安装缺失或过旧的 Node.js、安装 somora、注册后台服务并启动设置向导。
curl -fsSL https://somora.ai/install.sh | bash如果已经安装 Node.js ≥22.13,可通过 npm 安装并运行设置向导:
npm install -g somora && somora setup设置过程中需连接至少一个后端:Claude 订阅可使用 Claude Code 登录,ChatGPT 订阅可使用随 somora 提供的 Codex 登录;本地 Ollama、LM Studio、vLLM、oMLX 或其他 OpenAI-compatible 服务则需在初始化后写入 ~/.somora/config.yaml。
curl -fsSL https://claude.ai/install.sh | bash && claude auth loginsomora codex login硬性依赖还包括 tmux;Node.js 最低版本为 22.13。安装器可能在征得同意后使用管理员权限补齐系统依赖。
如何使用这个 Agent?
完成设置后,启动终端客户端即可向默认智能体发送第一条消息:
somora tui手动安装流程可先初始化配置并注册服务,然后启动服务器:
somora init
somora server start
somora tui创建多个智能体后,可初始化团队关系,使每个智能体知道成员及汇报结构:
somora team init --principal "<your name>"Web 客户端位于 https://<host>.<tailnet>.ts.net:18737/web/,移动 PWA 位于同一主机的 /mobile/。这些客户端连接同一台本地服务器,并共享智能体、会话队列和记忆。远程 Web 与移动访问使用 Tailscale HTTPS;README 说明该 Web 界面采用局域网信任模式,没有独立身份验证。
这个 Agent 有哪些优点和局限?
- 同一会话可在 Claude、ChatGPT、Grok 与 OpenAI-compatible 后端之间切换,历史和统一工具注册表能够延续。
- 私有记忆、共享 Obsidian wiki 与 REM、Deep、Lucid 三阶段 dream 流程形成明确的长期知识沉淀机制。
- TUI、浏览器桌面和移动 PWA 连接同一服务器、会话队列、智能体与记忆。
- 聊天智能体与 builder 分工明确;builder 为仓库工作提供长回合、计划、任务列表、编译器反馈和受限工作目录。
- 配置、会话、附件和记忆保存在用户机器上,并可使用 Ollama、LM Studio、vLLM 等本地模型服务。
- 仅文档化 Linux 和 macOS 安装路径,并硬性要求 Node.js ≥22.13、tmux 以及至少一个模型后端。
- 项目仍处于活跃开发和早期测试阶段,不等同于成熟的稳定版本。
- Web 与移动端的 HTTPS、麦克风、屏幕共享和剪贴板能力依赖 Tailscale 配置,且 Web 客户端采用无独立认证的局域网信任模式。
- Grok CLI 不能充当 dream 或 compaction worker,需要为这些任务配置另一个引擎。
- 托管图片和视频提供商虽按公开接口实现,但尚未使用真实账户完成端到端验证。
这个 Agent 与同类方案有什么区别?
与相关度最高的同类 agent 并排比较关键指标。
| Agent | 源码审查 | 形态 / 费用 | Star | 最近更新 | 主语言 | 完整支持的平台 |
|---|---|---|---|---|---|---|
| somora 当前 | 58 · 缺口较多 | 命令行工具免费 | ★ 35 | 4 天前 | TypeScript | ChatGPT · Codex · Claude Code |
| APX v2 智能体团队 | 51 · 缺口较多 | — | ★ 35 | 今天 | TypeScript | ChatGPT · Codex · Claude Code · Claude.ai · OpenAI API · Claude API |
| NextClaw | 61 · 存在缺口 | 桌面应用免费 + 模型费 | ★ 264 | 1 天前 | TypeScript | Codex · Claude Code |
| OpenHuman | 57 · 缺口较多 | 桌面应用免费版 + 付费版 | ★ 43k | 1 天前 | Rust | — |
FollowAgents 如何评估这个 Agent?
查看各维度的扣分理由
安全文档具体说明默认回环监听、请求密钥、凭据位置、部分文件与命令限制、更新检查数据及关闭方式,支持数据流和敏感信息处理得分;安装会询问管理员权限,部分知识晋升需审批。扣分原因是聊天代理可默认使用全部工具、代理并未沙箱化,且未显示普遍的外部操作确认与回滚机制;每日遥测仍是默认开启,依赖项也没有锁定文件或审计证据。来源可定位到仓库,但发布者身份未知,版权署名为“suspect”,因此来源归属仅部分清楚。
README、package 元数据和安全文档对 Node 版本、平台、存储与主要引擎大体一致,也列出必需和可选组件。扣分原因是资料只展示 package.json 中的版本范围,未给出锁定解析结果;不少产品能力是 README 自述,样本没有对应实现或测试;故障说明主要见于个别配置或安装提示,覆盖程度有限。
README 面向个人自托管、多代理协作、编码构建和多种客户端等具体场景,区分 chat agent 与 builder,也交代可选功能及若干运行环境要求。扣分原因是工具权限模型虽提到按代理配置,但默认能力较宽;触发适用条件主要由 README 和样例技能描述,缺少更广泛的边界证据;支持范围限定于 macOS 与特定 glibc Linux。
文档目录组织清楚,README 提供快速开始、手动安装、模型、客户端与功能文档入口;包名、版本、仓库地址和 MIT 许可证均明确。扣分原因是提供的样本没有贡献者或安全政策正文、FAQ、已知限制汇总或维护责任人证据;有发布说明入口,但样本未包含变更记录内容。模板和技能样例有具体用法,但不足以覆盖所有功能。
README 描述了统一工具、多客户端、长期记忆与多模型代理团队,若按描述工作,具有明确的使用价值;代理协作技能也提供具体交接格式和阶段选择。扣分原因是效果缺少本样本内的实现、运行或测试佐证,且运行时、磁盘和模型服务要求较高,成本收益无法充分确认。
安装要求、安全边界、遥测字段和技能设置步骤有具体文字,可追溯到所给文件;README 与 package.json 对包版本和 Node 要求存在部分交叉印证。扣分原因是多数功能主张没有样本内第二来源或代码佐证,且评估不能据此确认执行结果。文档将默认值、配置选项和限制分开描述,因此事实与产品主张有一定区分,但仍需把未经验证的宣传性陈述视为陈述。
- 安全文档明确指出代理不是沙箱程序,shell 和文件工具以运行服务的用户权限执行;应谨慎授予聊天代理工具权限,并保护服务密钥。
- 每日版本检查默认开启,会发送版本、操作系统、Node 版本和 CPU 信息;可通过 DO_NOT_TRACK=1 或配置关闭。
- 安装说明使用 curl 将远程脚本直接传给 bash;使用者应先审阅安装脚本及其下载来源。
- 本次仅依据所给静态样本,不能确认 README 中的功能、测试状态或实际运行结果。
最近版本
来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。
-
v2026.1116.11 v2026.1116.11 — coding-agent teams in tmux, a start menu, your answered questions stay in the chat
发布说明摘录
Before you update Nothing to do by hand. What you may notice: - The tmux tool reports agent: { name, state } instead of tui_state. The state is one of idle, working, blocked (a dialog waits for an answer) or unknown, read with [herdr](https://github.com/herdrdev/herdr)'s agent rules. kind is no longer needed: the agent is recognised by its process. An agent's own notes or skills that look for tui_state should look at agent.state. …在 GitHub 查看 ↗ -
v2026.1111.1 v2026.1111.1 — leaner builders, a security review, provider tools kept out, every dependency current
发布说明摘录
Before you update Nothing to do by hand. What you may notice: - Builders work differently. A builder's rules are now short tool rules instead of a method (tests as proof, evidence for every claim, a task list kept every few rounds); measured on five tasks against another coding harness on the same model, the short rules did every task at least as well and the hardest one better. A new session starts building right away — switch on the plan phase in the task panel when you want a plan first. The reminders to update the task list are gone; the list stays. Chat agents are unchanged. …在 GitHub 查看 ↗ -
v2026.1106.3 v2026.1106.3 — a settings window for config.yaml, builders held to what they deliver, voice calls from the phone and on your own models
发布说明摘录
Before you update Nothing to do by hand. What you may notice: - Builders work longer and are checked more. A builder is no longer told to wrap up at 75 % of its budget: it gets a checkpoint there and keeps working, and it has no round cap by default (the 2000 tool calls, the 8-hour clock and the loop guard brake a build). An order from another agent comes with a required acceptance list, and under every builder report somora adds the state of the working copy as it sees it. Chat agents are unchanged. …在 GitHub 查看 ↗
常见问题
必须购买云端模型订阅或 API 吗?
数据默认保存在哪里?
~/.somora/;工作区文件和生成媒体位于配置的 workspace;共享 wiki 位于用户选择的 Obsidian vault。外部模型和服务能接触哪些数据取决于用户配置。所有功能安装后都会自动启用吗?
imageGen 或 videoGen 前保持关闭。聊天智能体和 builder 有什么区别?
远程打开 Web 界面需要注意什么?
somora 官网是什么?
somora 免费吗?
somora 开源吗?
somora 安全吗?
somora 还在维护吗?
somora 是谁开发的?
谢谢反馈,我们会据此改进页面。