somora

在自己的机器上运行可共享长期记忆、自由切换模型的个人 AI 团队。

Star 数
★ 35
最近更新
4 天前
License
MIT
主语言
TypeScript

30 秒速览

运行形态
命令行工具自托管服务网页应用
可在哪里用
通用 · 跨平台ChatGPT · Codex · Claude Code
费用
免费,无需付费服务
上手难度
低 · 几分钟可跑通
开始前需要
Linux 或 macOSNode.js ≥22.13tmux至少一个受支持的 LLM 后端Shell / 命令行网络访问本地文件系统MCP Server
典型场景
希望在个人电脑上同时管理研究、协调和执行角色,并让它们互相委派任务的个人用户。
不适合
  • 需要原生 Windows 安装路径的用户
  • 不愿运行本地后台服务的团队
  • 要求生产稳定版而非活跃开发项目的组织
官网
somora.ai ↗ 来自 GitHub 仓库设置
维护状态
近 30 天有提交最近提交 2026-11-16最新版本 v2026.1116.11(2026-11-16)

这个 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。

  1. 希望在个人电脑上同时管理研究、协调和执行角色,并让它们互相委派任务的个人用户。
  2. 已经使用 Claude、ChatGPT、Grok 或本地模型,希望在同一会话中切换后端而不丢失历史和工具上下文的用户。
  3. 使用 Obsidian 管理知识,希望把聊天中反复出现的稳定信息沉淀为共享 wiki 的知识工作者。
  4. 需要把定时任务、浏览器操作、文件处理、shell 和 tmux 会话统一交给一组智能体的高级用户。
  5. 希望为代码仓库配置长期运行的 builder,同时保留普通聊天智能体负责沟通和任务交接的开发者。
  6. 希望从终端、桌面浏览器和手机访问同一套本地智能体、会话与记忆的用户。

安装与配置要点

摘自下方的安装和使用说明,以项目 README 的最新说明为准。

安装 / 启动命令
  • curl -fsSL https://somora.ai/install.sh | bash
  • npm install -g somora && somora setup
  • curl -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 login
somora 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?

FollowAgents 源码审查 · FARS-2.1
缺口较多
58/ 100 五分制 2.9 / 5
本评测基于 2026年11月8日 的源码;此后该项目发布了 2 个正式版本,尚未复审。分数与结论只代表评测时的版本。 最近版本 ↓
信任安全 13/29
可靠稳定 6/14
适用触发 14/18
规范维护 14/18
有效结果 7/13
证据核验 4/8
查看各维度的扣分理由
信任安全13 / 29 · 2.2/5

安全文档具体说明默认回环监听、请求密钥、凭据位置、部分文件与命令限制、更新检查数据及关闭方式,支持数据流和敏感信息处理得分;安装会询问管理员权限,部分知识晋升需审批。扣分原因是聊天代理可默认使用全部工具、代理并未沙箱化,且未显示普遍的外部操作确认与回滚机制;每日遥测仍是默认开启,依赖项也没有锁定文件或审计证据。来源可定位到仓库,但发布者身份未知,版权署名为“suspect”,因此来源归属仅部分清楚。

可靠稳定6 / 14 · 2.1/5

README、package 元数据和安全文档对 Node 版本、平台、存储与主要引擎大体一致,也列出必需和可选组件。扣分原因是资料只展示 package.json 中的版本范围,未给出锁定解析结果;不少产品能力是 README 自述,样本没有对应实现或测试;故障说明主要见于个别配置或安装提示,覆盖程度有限。

适用触发14 / 18 · 3.9/5

README 面向个人自托管、多代理协作、编码构建和多种客户端等具体场景,区分 chat agent 与 builder,也交代可选功能及若干运行环境要求。扣分原因是工具权限模型虽提到按代理配置,但默认能力较宽;触发适用条件主要由 README 和样例技能描述,缺少更广泛的边界证据;支持范围限定于 macOS 与特定 glibc Linux。

规范维护14 / 18 · 3.9/5

文档目录组织清楚,README 提供快速开始、手动安装、模型、客户端与功能文档入口;包名、版本、仓库地址和 MIT 许可证均明确。扣分原因是提供的样本没有贡献者或安全政策正文、FAQ、已知限制汇总或维护责任人证据;有发布说明入口,但样本未包含变更记录内容。模板和技能样例有具体用法,但不足以覆盖所有功能。

有效结果7 / 13 · 2.7/5

README 描述了统一工具、多客户端、长期记忆与多模型代理团队,若按描述工作,具有明确的使用价值;代理协作技能也提供具体交接格式和阶段选择。扣分原因是效果缺少本样本内的实现、运行或测试佐证,且运行时、磁盘和模型服务要求较高,成本收益无法充分确认。

证据核验4 / 8 · 2.5/5

安装要求、安全边界、遥测字段和技能设置步骤有具体文字,可追溯到所给文件;README 与 package.json 对包版本和 Node 要求存在部分交叉印证。扣分原因是多数功能主张没有样本内第二来源或代码佐证,且评估不能据此确认执行结果。文档将默认值、配置选项和限制分开描述,因此事实与产品主张有一定区分,但仍需把未经验证的宣传性陈述视为陈述。

风险与缓解建议
  • 安全文档明确指出代理不是沙箱程序,shell 和文件工具以运行服务的用户权限执行;应谨慎授予聊天代理工具权限,并保护服务密钥。
  • 每日版本检查默认开启,会发送版本、操作系统、Node 版本和 CPU 信息;可通过 DO_NOT_TRACK=1 或配置关闭。
  • 安装说明使用 curl 将远程脚本直接传给 bash;使用者应先审阅安装脚本及其下载来源。
  • 本次仅依据所给静态样本,不能确认 README 中的功能、测试状态或实际运行结果。
证据充分度:低 评估于 2026年11月8日 审查版本 1feaad08c807 评估后仓库已有新提交,评分可能未覆盖最新改动
查看完整评分方法 →
你是这个项目的维护者?把 FARS 徽章加到 README

徽章显示当前的评审分数和结论,点击回到本页。重新评审后约一小时内更新。

FARS

[![FARS 评测](https://followagents.com/badge/somora-agent.svg?lang=zh)](https://followagents.com/zh/agents/somora-agent)
<a href="https://followagents.com/zh/agents/somora-agent"><img src="https://followagents.com/badge/somora-agent.svg?lang=zh" alt="FARS 评测"></a>

最近版本

来自该项目 GitHub Releases 的最新发布记录,说明为上游原文摘录,未经本站改写或测试。

  1. 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 查看 ↗
  2. 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 查看 ↗
  3. 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 采用 MIT 许可证,并可连接 Ollama、LM Studio、vLLM、oMLX 等本地 OpenAI-compatible 服务;也可使用 Claude、ChatGPT 或 Grok 订阅。实际模型成本取决于所选择的后端。
数据默认保存在哪里?
配置、智能体私有记忆、会话和附件保存在 ~/.somora/;工作区文件和生成媒体位于配置的 workspace;共享 wiki 位于用户选择的 Obsidian vault。外部模型和服务能接触哪些数据取决于用户配置。
所有功能安装后都会自动启用吗?
不会。Obsidian wiki、Tailscale HTTPS、共享浏览器、实时语音、媒体生成、Sentinel 和外部 MCP 等功能需要分别配置;图片和视频生成在配置 imageGen 或 videoGen 前保持关闭。
聊天智能体和 builder 有什么区别?
聊天智能体负责对话、记忆、编排和 dream;builder 面向固定代码仓库,以长回合执行规划、编辑、运行和测试。builder 可以读取记忆,但不会写入记忆,也不会进行 dream。
远程打开 Web 界面需要注意什么?
文档给出的远程路径依赖 Tailscale HTTPS。Web 客户端采用局域网信任、无独立认证的模式,因此应谨慎控制可访问该网络和主机的设备。
somora 官网是什么?
somora 的 GitHub 仓库填写的官网是 https://somora.ai。这个链接由仓库作者设置;源码在 GitHub(thenaxon/somora_agent)。
somora 免费吗?
免费。somora 可以免费使用,不需要付费服务。
somora 开源吗?
开源。源码在 GitHub(thenaxon/somora_agent),许可证是 MIT。
somora 安全吗?
FollowAgents 的 FARS 评审(2026年11月8日)给 somora 的“信任与安全”打了 13/29 分。评审检查的 8 项安全措施没有完全缺失的。评审之后仓库已有更新。
somora 还在维护吗?
在维护。GitHub 上最近一次提交是 2026-11-16,在最近 30 天内。最新版本是 v2026.1116.11(2026-11-16)。
somora 是谁开发的?
somora 由 GitHub 账号 thenaxon 发布。FollowAgents 没有核实这个账号背后是哪个人或公司。
这页内容对你有帮助吗?
在 GitHub 查看 ↗ 安装 ↓

对比同类 Agent

用同一套 FARS 评审,横向比较这个 Agent 所属的短名单。

相关核心概念