![EverOS banner](https://github.com/EverMind-AI/EverOS/releases/download/v1.0.0/everos-readme-banner.jpg)

[官网](https://evermind.ai) · [文档](https://docs.evermind.ai) · [博客](https://evermind.ai/blogs) · [English](README.md)

目录

- [EverOS 1.0.0 亮点](#everos-100-亮点) - [什么是 EverOS](#什么是-everos) - [快速开始](#快速开始) - [架构概览](#架构概览) - [存储布局](#存储布局) - [功能](#功能) - [项目结构](#项目结构) - [文档](#文档) - [使用场景](#使用场景) - [持续关注](#持续关注) - [EverMind 生态](#evermind-生态) - [参与贡献](#参与贡献)

## EverOS 1.0.0 亮点 > [!IMPORTANT] > > **EverOS 1.0.0 是面向自进化记忆的一次重要发布。** 它带来了 > local-first 运行时、Markdown 作为 source of truth、混合检索、 > 多模态摄取、用户记忆与 Agent 记忆作用域，以及由 > [EverAlgo](https://github.com/EverMind-AI/EverAlgo) 支撑的模块化算法。 > > **欢迎 Watch 这个仓库。** 下一阶段我们会继续推进记忆系统方法， > 包括 Wiki 式知识层和用于更深层离线进化的 Dreaming。

Markdown-First Memory 记忆以普通 Markdown 持久化：可见、可审计、可手动编辑、Git 友好，并由用户自己拥有。	Lightweight Local Stack 用 Python 即可安装。SQLite 负责运行时状态；LanceDB 在本地提供向量、BM25 和结构化过滤检索。	Layered Memory Model 用户记忆和 Agent 记忆现在是一等公民。Wiki 式知识层是路线图中的下一层。
Self-Evolving Agents Agent 记忆可以从重复经验中提取可复用的 cases 和 skills，让工作流随着时间变得更聪明。	Multimodal Ingestion 文本、图片、音频、文档、PDF、HTML 和邮件都可以通过可选的多模态管线解析进记忆。	Online And Offline Strategy Control 在线提取和离线进化保持分离，并且每一步都可以配置 prompts 和 models。Dreaming 即将到来。
Orthogonal Memory Scope Owner、memory type 和 scope 相互独立：可以按 user、agent、app、project、session 和结构化 filters 搜索。	Progressive Disclosure 可读记忆界面保持简单，同时更深层的 facts、cases 和 skills 仍然可以被系统使用。	Modular By Design EverAlgo 负责算法；EverOS 负责运行时、持久化、在线流程和离线进化。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 什么是 EverOS EverOS 是一个开源 Python 框架，用来构建**跨 Agent、跨平台的自进化长期记忆**。它为 maker 提供一层可携带的统一记忆层，适用于他们使用的每一个 Agent： Claude Code、Codex、OpenClaw、Hermes 等等。这样，上下文、决策、文件和 Agent 轨迹可以跟着工作流走，而不是被锁在某一个工具里。 EverOS 会把对话、Agent 轨迹和文件保存为可读 Markdown，并同步本地 SQLite 和 LanceDB 索引，以便快速检索。Agent 可以复用过去的 cases 和 skills，从重复工作流中自我改进，并逐渐变得更加主动。系统围绕三个边界设计： 1. **记忆内容保持可读** - Markdown 是长期、耐用的 source of truth。 2. **运行时状态保持本地** - SQLite 跟踪状态；LanceDB 处理向量、BM25 和结构化过滤搜索。 3. **算法保持模块化** - [EverAlgo](https://github.com/EverMind-AI/EverAlgo) 负责记忆算法；EverOS 负责运行时、持久化、在线流程和离线进化。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 快速开始 ### 1. 安装 EverOS ```bash uv pip install everos # or: pip install everos ``` ### 2. 初始化配置生成一个 starter `.env` 文件，然后根据生成的注释填入 API key 字段。 ```bash everos init ``` `everos init` 默认写入 `./.env`。也可以使用 `everos init --xdg` 写入 `${XDG_CONFIG_HOME:-~/.config}/everos/.env`。 ### 3. 启动服务 ```bash everos --help everos server start ``` `everos server start` 会按以下顺序查找 `.env`：`--env-file ` → `./.env`（当前目录）→ `${XDG_CONFIG_HOME:-~/.config}/everos/.env` → `~/.everos/.env`。端点栈兼容 OpenAI protocol（OpenAI / OpenRouter / vLLM / Ollama / DeepInfra）。你可以覆盖生成的 `.env` 中的 `*__BASE_URL` 来指向任意这些模型服务。完整 walkthrough（添加对话、flush、search，然后读取 Markdown）见 [QUICKSTART.md](QUICKSTART.md)。 ### 可选：摄取多模态文件如果要通过 `/api/v1/memory/add` 的 `content` items 摄取非文本内容（image / pdf / audio / office documents），安装可选 extra： ```bash uv pip install 'everos[multimodal]' # or: pip install 'everos[multimodal]' ``` 这会引入 `everalgo-parser`（包含用于 SVG 支持的 `[svg]` bundle，通过 cairosvg）并接入多模态 LLM client（`.env` 中的 `EVEROS_MULTIMODAL__*` 字段，默认通过 OpenRouter 使用 `google/gemini-3-flash-preview`）。 **Office 文档支持需要 LibreOffice 作为系统依赖。** parser 会调用 `soffice`（LibreOffice 的 headless renderer），先把 `.doc` / `.docx` / `.ppt` / `.pptx` / `.xls` / `.xlsx` 转换为 PDF，再交给多模态 LLM。如果没有 LibreOffice，office 上传会返回 HTTP 415，并带有明确错误信息； PDF / image / audio / HTML / email 解析不受影响。在提供 office 文档服务前，请先在宿主机安装： ```bash brew install --cask libreoffice # macOS sudo apt-get install -y libreoffice # Debian / Ubuntu ``` ### 贡献者开发 ```bash git clone https://github.com/EverMind-AI/EverOS.git cd EverOS uv sync # creates ./.venv and installs deps source .venv/bin/activate # or prefix commands with `uv run` everos init # fill the four API key slots in .env (two distinct keys) everos --help make test ```

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 架构概览 ``` ┌───────────────────────────────────────────────┐ │ entrypoints/ (CLI + HTTP API) │ presentation ├───────────────────────────────────────────────┤ │ service/ (use cases: memorize/retrieve) │ application ├───────────────────────────────────────────────┤ │ memory/ (extract + search + cascade) │ domain ├───────────────────────────────────────────────┤ │ infra/ (markdown / sqlite / lancedb) │ infrastructure └───────────────────────────────────────────────┘ ↑ ↑ component/ core/ (LLM/Embedding) (observability/lifespan) ``` DDD 5 层架构，单向依赖。详见 [docs/architecture.md](docs/architecture.md)。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 存储布局 ``` ~/.everos/ ├── default_app/ # app_id ("default" → "default_app" on disk) │ └── default_project/ # project_id ("default" → "default_project") │ ├── users// │ │ ├── user.md # profile │ │ ├── episodes/ # daily-log episodes (visible) │ │ ├── .atomic_facts/ # nested facts (dotfile-hidden) │ │ └── .foresights/ # predictive memory (dotfile-hidden) │ └── agents// │ ├── agent.md │ ├── .cases/ # one task case per entry │ └── skills/ # named procedural memories ├── .index/ # derived indexes (rebuildable from md) │ ├── sqlite/system.db # state + queue + audit │ └── lancedb/*.lance/ # vector + BM25 + scalar └── .tmp/ # transient working files ``` 在 Obsidian 中打开任意 `//users//` 文件夹即可。你的 Agent 大脑本质上就是一组文件。dotfile 目录（`.atomic_facts/`、 `.foresights/`、`.cases/`）默认保持隐藏，因此可见文件夹仍然是面向用户的记忆表面，而提取出的衍生信息则安静地放在旁边。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 功能 - **混合检索**: BM25 + vector（HNSW/IVF-PQ）+ scalar filter，在 LanceDB 中完成单次查询 - **级联索引同步**: 编辑 `.md` → file watcher → entry-level diff → LanceDB sync，亚秒级同步 - **多源提取**: conversations / agent trajectories / file knowledge - **双轨记忆**: user-track（Episodes / Profiles）+ agent-track（Cases / Skills） - **异步优先**: 完整 asyncio，单一 event loop - **多模态**: text + 小图片 / audio inline；大媒体通过 S3/OSS reference

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 项目结构 ``` everos/ # repo root ├── src/everos/ # main package (src layout) │ ├── entrypoints/ # cli + api │ ├── service/ # use case orchestration │ ├── memory/ # domain: extract + search + cascade + prompt_slots │ ├── infra/ # storage: markdown + lancedb + sqlite │ ├── component/ # cross-cutting: llm / embedding / config / utils │ ├── core/ # runtime: observability / lifespan / context │ └── config/ # configuration data + Settings schema ├── tests/ # unit / integration / golden / fixtures ├── docs/ # design docs └── .claude/ # team-shared rules + skills (auto-loaded by Claude Code) ```

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 文档 - [docs/overview.md](docs/overview.md) - 项目概览与愿景 - [docs/architecture.md](docs/architecture.md) - DDD 分层架构与依赖规则 - [docs/engineering.md](docs/engineering.md) - 工程与开发效率基础设施（CI / tooling / Claude Code） - [docs/use-cases.md](docs/use-cases.md) - 完整使用场景 gallery 和集成示例 - [docs/migration-to-1.0.0.md](docs/migration-to-1.0.0.md) - Legacy API 与基础设施迁移说明 - [CHANGELOG.md](CHANGELOG.md) - 发布记录 - [CONTRIBUTING.md](CONTRIBUTING.md) - 如何贡献 - [.claude/rules/](.claude/rules/) - 详细代码规范（Claude Code 会自动加载）

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 使用场景这些使用场景展示了持久记忆可以在真实产品和工作流中带来什么能力。有些示例已经打包在本仓库中，另一些则指向外部 demo 或集成，你可以研究并复用。

[![banner-gif](https://github.com/user-attachments/assets/840470d7-a838-4c05-8685-dd797d4e9cdf)](https://evermind.ai/usecase_reunite) #### Reunite - 用 EverOS 找回连接父母描述他们记得的线索，孩子描述他们残留的回忆。Reunite 使用语义记忆来浮现这些连接。 [了解更多](https://evermind.ai/usecase_reunite)	[![banner-gif](https://github.com/user-attachments/assets/7282b38b-56bf-4356-aa7b-06a845e7683d)](https://github.com/tt-a1i/hive) #### Hive Orchestrator 面向 CLI coding agents 的 browser-native hive-mind。Claude Code、Codex、Gemini 和 OpenCode 作为真实 PTY 进程，通过团队协议协作。 [代码](https://github.com/tt-a1i/hive)
[![banner-gif](https://github.com/user-attachments/assets/867d9329-ce9a-496f-ab1e-15c77974e5fa)](https://github.com/tt-a1i/evermemos-mcp) #### 接入 EverOS 的 AI 编程助手由 EverOS 驱动的通用长期记忆层，面向 AI coding assistants。 [代码](https://github.com/tt-a1i/evermemos-mcp)	[![banner-gif](https://github.com/user-attachments/assets/a4f0fd86-1c81-4445-bebc-e51eb5e33b30)](https://github.com/yuansui123/AI-Data-Technician-EverMemOS) #### AI Data Technician 一个 agentic AI 系统，可以从科学家的交互中学习，用于检查、分析和分类高维时间序列数据，并通过跨 session 改进的持久记忆持续变强。 [代码](https://github.com/yuansui123/AI-Data-Technician-EverMemOS)
![banner-gif](https://github.com/user-attachments/assets/650b901b-c9ba-4001-bac7-626b009df830) #### 接入 EverOS 的 Rokid AI 助手在 Rokid Glasses 中连接 EverOS，为你的智能活动启用长期记忆。即将推出	![banner-gif](https://github.com/user-attachments/assets/85b338b2-e48e-4a65-9f30-0bc6998df872) #### 带长期记忆的创意助手拥有长期记忆的创意助手，让你的创作上下文可以跨 session 持续可用。即将推出

[![banner-gif](https://github.com/user-attachments/assets/f30617a1-adc0-4271-bc0e-c3a0b28cb903)](https://github.com/xunyud/Earth-Online) #### Earth Online 记忆游戏 Earth Online 是一款 memory-aware productivity game，把日常计划变成一个持续生长的 quest log。 [代码](https://github.com/xunyud/Earth-Online)	[![banner-gif](https://github.com/user-attachments/assets/57d8cda7-35a5-4561-b794-5520dffc917b)](https://github.com/golutra/golutra) #### 多 Agent 编排平台 Golutra 为工程团队提供 multi-agent workforce，把 IDE 从单一 assistant 扩展为协同 agents。 [代码](https://github.com/golutra/golutra)
[![banner-gif](https://github.com/user-attachments/assets/75f19db5-30f6-4eed-9b1e-c9c6a0e6b7de)](https://github.com/Yangtze-Seventh/taste-verse) #### 你的个人品鉴宇宙通过沉浸式 3D 星图记录、可视化并探索你的 tasting journey。 [代码](https://github.com/Yangtze-Seventh/taste-verse)	[![banner-gif](https://github.com/user-attachments/assets/93ac2a68-4f18-4fcb-8d87-80aeb00a9d7c)](https://github.com/kellyvv/OpenHer) #### EverOS Open Her 构建有感受的 AI。开源 persona engine，让 personality 从 neural drives 中涌现，而不是来自 prompts。灵感来自 Her。 [代码](https://github.com/kellyvv/OpenHer)
[![banner-gif](https://github.com/user-attachments/assets/550071c1-dc39-4964-9f67-ffdfad792345)](https://chromewebstore.google.com/detail/ruminer-browser-agent/lbccjohfpdpimbhpckljimgolndfmfif) #### 面向个人记忆的浏览器 Agent Ruminer 为 browser agent 带来持久记忆，让它能在不同网页任务之间携带个人上下文。 [插件](https://chromewebstore.google.com/detail/ruminer-browser-agent/lbccjohfpdpimbhpckljimgolndfmfif)	[![banner-gif](https://github.com/user-attachments/assets/c258a6c4-fe70-497a-98d1-3dade4a932f6)](https://github.com/nanxingw/EverMem) #### EverMem 与 EverOS 同步一条命令，把任意 AI coding CLI 连接到 EverMemOS 长期记忆。 [代码](https://github.com/nanxingw/EverMem)

[![banner-gif](https://github.com/user-attachments/assets/39274473-ceb3-48fb-a031-e22230decbe2)](https://github.com/mco-org/mco) #### MCO - 编排 AI Coding Agents MCO 为你的主 Agent 配备一个 agent team，让它们可以一起处理复杂任务。 [代码](https://github.com/mco-org/mco)	[![banner-gif](https://github.com/user-attachments/assets/314c9126-8e08-4688-bbbb-8555ad58cf67)](https://github.com/onenewborn/StudyBuddy-public) #### 带自进化记忆的 Study Buddy 使用拥有 self-evolving memory 的 Agent，主动辅助学习。 [代码](https://github.com/onenewborn/StudyBuddy-public)
[![banner-gif](https://github.com/user-attachments/assets/21da76aa-9a8b-48e0-9134-42429d7390e7)](https://github.com/TonyLiangDesign/MemoCare) #### 阿尔茨海默症记忆助手通过高级记忆支持和日常辅助，帮助有需要的人更好地生活。 [代码](https://github.com/TonyLiangDesign/MemoCare)	[![banner-gif](https://github.com/user-attachments/assets/e2428df3-ea11-4e88-8f9c-dad437dd8998)](https://github.com/AlexL1024/NeuralConnect) #### 记忆驱动的 Multi-Agent NPC 体验一款 iOS 科幻悬疑游戏，玩家可以探索世界并揭开真相。 [代码](https://github.com/AlexL1024/NeuralConnect)
[![banner-gif](https://github.com/user-attachments/assets/e6eaf308-a874-483f-8874-6934bf95a78f)](https://github.com/elontusk5219-prog/Mobi) #### Mobi Companion 一款 iOS app，用户可以创建、养成并与名为 Mobi 的个性化 AI companion 一起生活。 [代码](https://github.com/elontusk5219-prog/Mobi)	[![banner-gif](https://github.com/user-attachments/assets/9aabcaa9-f97a-49d2-9109-0b5bb696ed41)](https://github.com/JaMesLiMers/EvermemCompetition-Spiro) #### 带记忆的 AI 可穿戴设备一个 context-native AI wearable，聆听日常生活，并把对话转换为记忆。 [代码](https://github.com/JaMesLiMers/EvermemCompetition-Spiro)

[![banner-gif](https://github.com/user-attachments/assets/df9677ec-386f-4c56-a428-08bca25c54dc)](docs/migration-to-1.0.0.md) #### Legacy OpenClaw Agent 记忆已归档的 pre-1.0.0 plugin reference。新的集成应使用 EverOS 1.0.0 API。 [了解更多](docs/migration-to-1.0.0.md)	[![banner-gif](https://github.com/user-attachments/assets/3a2357a1-c0c3-464a-8979-0d1cdfc9b0d4)](https://github.com/TEN-framework/ten-framework/tree/04cb80601374fa9e35b4e544b2dbd23286ca7763/ai_agents/agents/examples/voice-assistant-with-EverMemOS) #### 带记忆的 Live2D 角色为实时 Live2D character 添加长期记忆，由 [TEN Framework](https://github.com/TEN-framework/ten-framework) 驱动。 [代码](https://github.com/TEN-framework/ten-framework/tree/04cb80601374fa9e35b4e544b2dbd23286ca7763/ai_agents/agents/examples/voice-assistant-with-EverMemOS)
[![banner-gif](https://github.com/user-attachments/assets/c36bdc04-97d3-4fe9-97d9-4b93b475595a)](https://screenshot-analysis-vercel.vercel.app/) #### 带记忆的 Computer-Use 运行基于截图的分析任务，并把结果存入记忆。 [在线演示](https://screenshot-analysis-vercel.vercel.app/)	[![banner-gif](https://github.com/user-attachments/assets/54a7cf8f-62c4-4fbc-9d50-b214d034e051)](use-cases/game-of-throne-demo) #### Game Of Thrones Memories 通过与 A Game of Thrones 互动问答体验，展示 AI 记忆基础设施。 [代码](use-cases/game-of-throne-demo)
[![banner-gif](https://github.com/user-attachments/assets/af37c1f6-7ba5-430c-b99d-2a7e7eac618f)](use-cases/claude-code-plugin) #### Claude Code Plugin Claude Code 的持久记忆插件。自动保存并回忆过去 coding sessions 的上下文。 [代码](use-cases/claude-code-plugin)	[![banner-gif](https://github.com/user-attachments/assets/d521d28c-0ccd-44ff-aecc-828245e2f973)](https://main.d2j21qxnymu6wl.amplifyapp.com/graph.html) #### 记忆图谱可视化在图界面中探索已存储的 entities 和 relationships。前端 demo 已可用；后端集成仍在进行中。 [在线演示](https://main.d2j21qxnymu6wl.amplifyapp.com/graph.html)

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 持续关注 Star 这个仓库，或加入上面的社区链接，以持续关注新的架构方法、benchmark releases、 memory-enabled use cases、Wiki 式记忆和 Dreaming 更新。 ![star us gif](https://github.com/user-attachments/assets/0c512570-945a-483a-9f47-8e067bd34484) ### Star 趋势 [![Star 趋势图](https://api.star-history.com/svg?repos=EverMind-AI/EverOS&type=Date)](https://www.star-history.com/#EverMind-AI/EverOS&Date)

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## EverMind 生态 EverMind 是一个面向长期记忆、自进化 Agent 和记忆评测的开源生态。 EverOS 是核心运行时架构；EverMemOS 是论文与研究线，承载我们最强的 memory-system benchmark runs；EverAlgo 提供让系统保持模块化和可复用的下一代算法。

EverMind 开源生态
核心记忆架构	EverOS / EverMemOS - 本地记忆操作系统，以及有研究支撑的 Agent 和用户记忆运行时。
算法引擎	EverAlgo - stateless extraction、ranking、parsing 和 memory operators，为 EverOS 提供算法能力。
替代架构	HyperMem - 面向长期对话的 hypergraph memory，拥有独立的 benchmark-backed topic -> episode -> fact 检索方法。
Benchmarks	EverMemBench · EvoAgentBench - conversational memory 和 Agent self-evolution 的评测套件。
Long-Context Research	MSA - Memory Sparse Attention，用于可扩展 latent memory 和 100M-token contexts。
个人记忆层	EverMe - CLI 和 Agent plugin suite，用于跨设备、跨 Agent 的个人记忆。
开发者集成	evermem-claude-code · everos-plugins - AI coding agents 的 plugins、skills 和 migration tooling。

这些仓库共同构成 EverMind 的 research-to-runtime stack：新的记忆方法、可复用算法、 benchmark evidence，以及可落地的 Agent 集成。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)

## 参与贡献欢迎为整个仓库贡献：架构方法、benchmark coverage、use-case examples、文档和 bug fixes。浏览 [Issues](https://github.com/EverMind-AI/EverOS/issues) 找到适合的切入点，准备好后即可提交 PR。
> [!TIP] > > **欢迎各种形式的贡献** 🎉 > > 一起让 EverOS 变得更好。代码、文档、benchmark reports、use-case write-ups > 和 integration examples 都很有价值。也欢迎在社交媒体上分享你的项目，启发更多人。 > > 你可以在 𝕏 上联系 EverOS maintainer [@elliotchen200](https://x.com/elliotchen200)， > 或在 GitHub 上联系 [@cyfyifanchen](https://github.com/cyfyifanchen)，获取项目更新、 > 讨论和协作机会。 ![divider](https://github.com/user-attachments/assets/2e2bbcc6-e6d8-4227-83c6-0620fc96f761#gh-light-mode-only) ![divider](https://github.com/user-attachments/assets/d57fad08-4f49-4a1c-bdfc-f659a5d86150#gh-dark-mode-only) ### 代码贡献者 [![EverOS Contributors](https://contrib.rocks/image?repo=EverMind-AI/EverOS)](https://github.com/EverMind-AI/EverOS/graphs/contributors) ![divider](https://github.com/user-attachments/assets/2e2bbcc6-e6d8-4227-83c6-0620fc96f761#gh-light-mode-only) ![divider](https://github.com/user-attachments/assets/d57fad08-4f49-4a1c-bdfc-f659a5d86150#gh-dark-mode-only) ### 许可证 [Apache License 2.0](LICENSE) - 第三方归属说明请见 [NOTICE](NOTICE)。 ### 引用如果你在研究中使用 EverOS，请参考 [CITATION.md](CITATION.md)。

[![](https://img.shields.io/badge/-Back_to_top-gray?style=flat-square)](#readme-top)