本地优先的 Agent 工作空间,将应用、聊天工具、集成与共享记忆放在同一处,可接入 Claude Code、Codex 等多种 Agent。
mengrru/Spherse
本地运行的个人 Agent 运行时,多个 Agent 共享项目文件,可定时或事件触发,并驱动交互式 HTML 应用。
- Star
- 91
- Fork
- 12
- 未关闭 Issue
- 21
- 最近提交
- 12小时前
这是什么?
Spherse 是一个本地运行 Agent 的运行时,多个 Agent 围绕同一个项目目录工作。项目中的普通文件就是用户数据,每个 Agent 可以拥有独立的系统提示词、工具权限、私有与共享 Skill、MCP Server 连接、多个持久化会话和聊天主题。会话保存在项目内的 SQLite 数据库中,Agent 配置使用 Markdown、YAML 和 JSON 格式。
自动化通过 Trigger 实现:Agent 可以按 Cron 表达式定时运行,也可以响应带 payload 的自定义事件,事件来源可以是用户、HTML 页面或其他 Agent。内置的本地 HTTP 预览服务器可直接浏览项目中的 HTML 与图片,页面通过 UI SDK 读写 JSON 数据、创建会话、向 Agent 发送消息并触发事件。
桌面端基于 Electron 和 React,支持 macOS、Windows 和 Linux;带访问令牌的 Web 客户端可让移动设备连接桌面运行时。整个项目目录可以作为一个单元复制或分享,数据、Agent 配置、Skill、自动化规则和页面都会一并保留。
核心功能
- 01同一项目内可配置多个 Agent,各自拥有独立提示词、工具权限、Skill 和 MCP 连接
- 02支持 Cron 定时与自定义事件两种 Trigger,可在新会话或指定会话中运行
- 03内置本地 HTML 预览服务,并提供 UI SDK 读写数据、驱动 Agent
- 04数据本地保存:普通文件、Markdown/YAML/JSON 配置与 SQLite 会话存储
- 05提供 macOS、Windows、Linux 桌面端,以及带访问令牌的移动 Web 客户端
适用场景
- 由多个角色持续维护的世界观设定与互动叙事
- 搭建带仪表盘和定时日报的个人记录系统
- 让研究、摘要、归档 Agent 围绕同一知识目录协作
- 开发读取本地数据并调用 Agent 的自定义 HTML 工具
快速上手
- 1
克隆仓库
git clone https://github.com/mengrru/Spherse.git - 2
进入项目目录
cd Spherse - 3
安装依赖
npm install - 4
以开发模式启动应用
npm run dev
使用前须知
- 本地开发需要 Node.js 22.19 或更高版本。
- 创建 Agent 前需要配置受支持的 LLM 提供商 API Key。
- macOS 版本未使用 Apple 开发者证书签名,首次打开时可能出现安全提示。
收录于专题
标签
常见问题
- Spherse 是什么?
- 本地运行的个人 Agent 运行时,多个 Agent 共享项目文件,可定时或事件触发,并驱动交互式 HTML 应用。 Spherse 是一个本地运行 Agent 的运行时,多个 Agent 围绕同一个项目目录工作。项目中的普通文件就是用户数据,每个 Agent 可以拥有独立的系统提示词、工具权限、私有与共享 Skill、MCP Server 连接、多个持久化会话和聊天主题。会话保存在项目内的 SQLite 数据库中,Agent 配置使用 Markdown、YAML 和 JSON 格式。
- Spherse 可以免费使用吗?用的什么许可证?
- Spherse 以 MIT 许可证开源。用于商业产品前,请先确认许可证条款。
- Spherse 还在维护吗?
- 活跃维护中。Spherse 最近一次提交是在 2026年10月22日。
- Spherse 适合用来做什么?
- 由多个角色持续维护的世界观设定与互动叙事 搭建带仪表盘和定时日报的个人记录系统 让研究、摘要、归档 Agent 围绕同一知识目录协作 开发读取本地数据并调用 Agent 的自定义 HTML 工具
- Spherse 怎么安装和运行?
- 克隆仓库: git clone https://github.com/mengrru/Spherse.git 进入项目目录: cd Spherse 安装依赖: npm install 以开发模式启动应用: npm run dev
- 在哪里获取 Spherse?
- 源代码和安装说明在 GitHub 上:https://github.com/mengrru/Spherse
概要由 AI 根据项目 README 生成;GitHub 数据每日更新。
相关项目
基于 Electron 的本地优先浏览器,AI 代理可通过 MCP 或 HTTP API 在你已登录的真实会话中操作网页。
一款免费开源的桌面 AI 应用,可处理文件、文档、浏览器、邮件和定时任务,高风险操作需先获得批准。
网易有道开源的桌面级 AI Agent,可在本地文件上完成办公任务,并通过微信、飞书等即时通讯工具远程下发指令。
一个用 Go 编写、可在本机 24/7 运行的自托管 AI 智能体,能自动生成缺失工具,并通过 MCP 与其他智能体共享。
Apache Maka(孵化中)是一个智能体工作台,提供桌面端、TUI 和 CLI,将每条模型消息、工具调用和权限决策记录为只追加的事件日志。