Repolode
mengrru

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. 1

    克隆仓库

    git clone https://github.com/mengrru/Spherse.git
  2. 2

    进入项目目录

    cd Spherse
  3. 3

    安装依赖

    npm install
  4. 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 数据每日更新。

相关项目