Repolode
EverMind-AI

EverMind-AI/EverOS

面向 AI 智能体的本地优先、Markdown 原生长期记忆层,记忆以可编辑文件保存并配合 SQLite 与 LanceDB 索引。

Star
13,525
Fork
1,074
未关闭 Issue
58
最近提交
6小时前

这是什么?

EverOS 是一个 Python 库和本地优先的记忆运行时,让 AI 智能体在编程助手、应用和工作流之间保留持久记忆。对话、文件和智能体执行轨迹会以可读的 Markdown 文件保存,作为唯一的数据源,可以直接编辑、对比差异并用 Git 做版本管理。

本地的 SQLite 与 LanceDB 索引层负责检索这些 Markdown 内容。记忆分为用户侧(episodes 与 profile)和智能体侧(cases 与 skills)两条线,检索可按 user_id、agent_id、app_id、project_id 和 session_id 进行限定。离线的反思步骤会在会话之间合并记忆簇,并完善用户画像和技能。

服务端在 /api/v2 下提供 HTTP 接口。最小配置只需一个 OpenRouter API key,即可完成写入、刷新和关键词检索。嵌入、重排序和多模态模型是可选的,配置后可启用混合检索、Knowledge Wiki,以及图片、PDF、音频和办公文档的导入。

核心功能

  • 01将记忆保存为可直接编辑、可用 Git 管理版本的 Markdown 文件。
  • 02使用本地 SQLite 与 LanceDB 建立索引,无需额外部署外部数据库。
  • 03用户的 episodes/profile 与智能体的 cases/skills 分开管理。
  • 04检索可按 user_id、agent_id、app_id、project_id、session_id 限定范围。
  • 05通过离线反思合并记忆簇,并完善用户画像和技能。
  • 06提供 /api/v2 版本化 HTTP 接口,并附带独立演示和命令行工具。

适用场景

  • 通过 MCP 为 Claude Code、Cursor 等编程助手提供跨会话的项目记忆。
  • 为聊天机器人或语音助手后端添加长期用户记忆。
  • 以可审计、可人工编辑的 Markdown 文件保存智能体记忆,并用 Git 管理。
  • 在 Dify 等工作流工具中通过插件接入持久记忆。

快速上手

  1. 1

    使用 uv 安装 EverOS

    uv pip install everos
  2. 2

    运行独立演示(无需密钥)

    everos demo
  3. 3

    初始化配置,并在 ~/.everos/everos.toml 中填入 OpenRouter API 密钥

    everos init
  4. 4

    启动 EverOS 服务

    everos server start

使用前须知

  • 完整的记忆功能需要 OpenRouter API 密钥;混合和向量检索还需要额外的嵌入模型服务。
  • 办公文档导入需要在系统中安装 LibreOffice。
  • 可选服务和配置文件较多,自托管需要一定的配置工作。

标签

常见问题

EverOS 是什么?
面向 AI 智能体的本地优先、Markdown 原生长期记忆层,记忆以可编辑文件保存并配合 SQLite 与 LanceDB 索引。 EverOS 是一个 Python 库和本地优先的记忆运行时,让 AI 智能体在编程助手、应用和工作流之间保留持久记忆。对话、文件和智能体执行轨迹会以可读的 Markdown 文件保存,作为唯一的数据源,可以直接编辑、对比差异并用 Git 做版本管理。
EverOS 可以免费使用吗?用的什么许可证?
EverOS 以 Apache-2.0 许可证开源。用于商业产品前,请先确认许可证条款。
EverOS 还在维护吗?
活跃维护中。EverOS 最近一次提交是在 2026年10月20日。
EverOS 适合用来做什么?
通过 MCP 为 Claude Code、Cursor 等编程助手提供跨会话的项目记忆。 为聊天机器人或语音助手后端添加长期用户记忆。 以可审计、可人工编辑的 Markdown 文件保存智能体记忆,并用 Git 管理。 在 Dify 等工作流工具中通过插件接入持久记忆。
EverOS 怎么安装和运行?
使用 uv 安装 EverOS: uv pip install everos 运行独立演示(无需密钥): everos demo 初始化配置,并在 ~/.everos/everos.toml 中填入 OpenRouter API 密钥: everos init 启动 EverOS 服务: everos server start
在哪里获取 EverOS?
源代码和安装说明在 GitHub 上:https://github.com/EverMind-AI/EverOS

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目