EverOS 教程：先用虚构对话检查记忆边界
EverOS 把对话抽取为本地 Markdown，再把内容投影到 SQLite 和 LanceDB 索引。文件保存在本机，但抽取、向量和重排可能调用外部模型提供方，所以“本地优先”不等于完全离线。
1. 先跑不接服务的演示
python3 -m venv .venv source .venv/bin/activate python3 -m pip install "everos==1.3.1" everos demo --plain
官方说明普通 demo 是硬编码预览，不需要 key，不启动服务器，也不写真实记忆目录。它只能检查界面，不能验证真实抽取质量。
2. 为测试单独建根目录
everos init --root ./everos-test # 只在测试配置中填写低额度 LLM key everos server start --root ./everos-test
官方最小流程使用 OpenRouter。不要提交配置文件，也不要使用真实聊天记录。服务默认只监听 127.0.0.1:8000，暴露到其他网卡前要加认证和访问控制。
3. 先使用 keyword 层
health 返回能力矩阵。只有 LLM 时可写 Markdown、同步索引和使用 keyword search；向量、混合、agentic search、反思和知识能力会关闭。缺少 embedding 时，默认 hybrid 方法会返回 422，因此请求中要明确指定 keyword。
4. 检查源文件和删除边界
用虚构的姓名与偏好测试 add、flush 和 search。确认 Markdown 出现在指定 root，索引更新后能检索，删除和备份策略也符合预期。启用 embedding 或多轮检索前，先确认发送给外部提供方的字段。
与 LangGraph memory 对比
LangGraph 官方内存分为线程级短期记忆和跨会话长期 Store，生产示例使用数据库 checkpointer。EverOS 使用独立 API，并把 Markdown 作为可读源数据。已有 LangGraph 应用只需图状态持久化时可沿用其 memory；需要跨应用 Markdown 记忆目录时再评估 EverOS。
这里仅补原教程没有展开的事实和边界。安装命令与操作步骤仍以前文为准。
先判断这个项目是否适合你
适合谁用
适合需要可阅读、可迁移记忆文件的本地代理原型和个人知识流程。聊天内容、偏好和文件可能包含敏感信息；本地优先不等于完全离线，抽取和可选检索提供方仍可能接收内容。
采用建议
EverOS 的差异在于用 Markdown 保存可读源数据，同时提供本地检索服务。评估时先用虚构对话和 keyword tier，确认目录、删除、备份与 provider 数据边界，再考虑 embedding 和多轮检索。
原教程未展开的系统信息
核心功能
Markdown 记忆源
对话抽取结果写入按用户、应用和项目组织的 Markdown 文件，使用者可以直接查看和版本管理。
分层检索能力
仅配置 LLM 时支持关键词检索；增加 embedding 和 rerank 后才启用向量、混合、agentic 等能力。
本地 API 服务
FastAPI 服务提供 add、flush、search 和 health 等接口，当前业务接口使用 /api/v2，/api/v1 是兼容别名。
多轮检索与基准
v1.3.1 加入 llm_multiround 搜索，并统一 LoCoMo、LongMemEval、EverMemBench 和 SubtleMemory 的运行流程。
架构与数据流
客户端把消息提交给本地 API，EverOS 按会话缓存，在边界或 flush 时调用 LLM 抽取并写入 Markdown。cascade worker 再把内容投影到 SQLite/LanceDB 索引。关键词检索可在没有 embedding 的情况下工作；向量、重排、知识库和反思需要额外提供方。
技术栈和运行条件
语言
Python 3.12+
框架
FastAPI、SQLModel/SQLite、LanceDB、Markdown、Typer/Textual
关键依赖
- LLM 提供方，官方最小示例使用 OpenRouter
- 可选 embedding、rerank 和 multimodal provider
- everalgo 组件
- 本地文件系统
运行环境
默认服务为 127.0.0.1:8000；默认记忆根目录 ~/.everos
常见问题
EverOS v1.3.1 最低需要哪个 Python 版本？
官方包元数据要求 Python 3.12 及以上，并列出 Python 3.12 和 3.13。
EverOS 没有 embedding key 还能搜索吗？
可以使用 keyword 方法。向量、混合、agentic search、反思和部分知识能力会被禁用；默认 hybrid 方法在缺少 embedding 时会返回 422。
everos demo 会写入真实记忆吗？
不会。官方说明普通 demo 是硬编码预览，不启动服务器、不调用真实流程，也不写默认记忆目录。
EverOS 本地优先是否等于完全离线？
不等于。Markdown 和索引保存在本机，但真实抽取需要配置 LLM，embedding、rerank 和多模态功能也可能调用外部提供方。