返回目录

everos

维护状态: 活跃

evermind-ai/everos

为所有 AI 智能体提供的便携统一记忆层,本地优先、Markdown 原生、数据归用户所有,跨应用与工作流自进化。

前往 GitHub项目主页
$ dsh plugin add everos

12,793

星标

913

Fork

Python

语言

Apache-2.0

许可证

2025-10-28

创建于

2026-09-08

最近推送

Apache-2.0 本地优先、Markdown 原生的智能体记忆运行时;DeepSeek Harness 通过本地 HTTP API(/api/v2)或 MCP 桥接接入,获得持久长期记忆。

DSH 适配

兼容

作者声明

安全审计

未审计

最后核验

2026-08-21

许可证

Apache-2.0

01它能帮你完成什么?

  • Give DeepSeek Harness sessions persistent long-term memory

    Durable memories stored as readable Markdown under ~/.everos, with local SQLite and LanceDB indexes and keyword search recall via the local HTTP API

    Developers running DeepSeek Harness (dsh) or other coding agents who want cross-session context that survives restarts

  • Try the memory ingest -> extract -> index -> recall loop in minutes

    A running local server with one-key setup: memory add, flush, Markdown persistence, cascade indexing, and keyword search

    Builders evaluating agent memory options who want a no-infrastructure trial before committing

  • Ingest multimodal content into agent memory

    Image, PDF, audio, and office-file ingestion through /api/v2/memory/add via the optional multimodal extra

    Teams whose agent context includes documents, screenshots, and audio rather than plain text

02如何接入 DeepSeek Harness?

前置条件

  • Python 3.12+
  • One OpenRouter API key (https://openrouter.ai/keys)

安装步骤

  1. 01

    Install the package: `uv pip install everos` (or `pip install everos`)

  2. 02

    Run `everos init` — this creates `~/.everos/everos.toml` and `~/.everos/ome.toml`; replace the empty `api_key` in `~/.everos/everos.toml` with your OpenRouter key (use `everos init --root <path>` for a different memory root)

  3. 03

    Start the server: `everos server start`

  4. 04

    Add memories and search them via the HTTP API, e.g. POST /api/v2/memory/add, /api/v2/memory/flush, /api/v2/memory/search (use `"method": "keyword"` in the one-key setup)

  5. 05

    Optional: `uv pip install 'everos[multimodal]'` for image / PDF / audio / office-file ingestion

验证接入成功

  • Open a second terminal and run `curl http://127.0.0.1:8000/health` — look for `"status":"ok"`; with the one-key setup `capabilities.llm` is `true` while embedding and rerank remain `false`
  • Add a tiny conversation via /api/v2/memory/add, flush it, then search it back via /api/v2/memory/search — you should see the stored memory in the response

03DSH 适配与能力边界

DSH 适配兼容

Local-first memory server that DeepSeek Harness can call through the local HTTP API (/api/v2/memory/add, /flush, /search) or community MCP bridges; the README documents EverOS as a universal long-term memory layer for AI coding assistants

  • Markdown-native memory persistence

    conversations, files, and agent trajectoriescanonical readable/editable/diffable .md files under the memory root (~/.everos), Git-versionable

    writes Markdown files and syncs local SQLite and LanceDB indexes on diskcascade watcher re-syncs indexes when you edit .md files directly
  • Local HTTP memory API with orthogonal retrieval

    memory add / flush / search requests with user_id, agent_id, app_id, project_id, session_idkeyword (Tier 1) or hybrid search results from the local index; business endpoints live under /api/v2

    starts a local server on 127.0.0.1:8000sends prompts to the configured OpenRouter endpoint when the llm capability is enabled
  • Tiered capability upgrades (embedding / rerank / multimodal)

    optional [embedding], [rerank], [multimodal] sections in everos.tomlhybrid search, reflection and skill extraction; agentic search and Knowledge Wiki; image / PDF / audio / office ingestion

    extra providers mean additional API calls and costsmultimodal extra pulls in everalgo-parser; office documents additionally require LibreOffice as a system dependency
  • Offline reflection (self-evolving memory)

    accumulated episode clusters between sessionsmerged episodes and refined user profiles and agent skills without online traffic

    requires an embedding provider to be configured; mutates stored memory state during consolidation

04适合谁?何时不该用?

适合

  • Developers running DeepSeek Harness (dsh) or other coding agents who want cross-session context that survives restarts
  • Builders evaluating agent memory options who want a no-infrastructure trial before committing
  • Teams whose agent context includes documents, screenshots, and audio rather than plain text

不适合

  • The one-key OpenRouter setup is Tier 1 only (memory add/flush, Markdown persistence, cascade indexing, keyword search). Hybrid search defaults require an embedding provider, and unconfigured features return HTTP 422.

05兼容性、维护与安全提示

  • The one-key OpenRouter setup is Tier 1 only (memory add/flush, Markdown persistence, cascade indexing, keyword search). Hybrid search defaults require an embedding provider, and unconfigured features return HTTP 422.
  • Office document ingestion (.doc/.docx/.ppt/.pptx/.xls/.xlsx) requires LibreOffice installed on the host; without it, office uploads return HTTP 415 (PDF/image/audio/HTML/email parsing is unaffected).
  • Core flows require Python 3.12+ and a paid OpenRouter API key stored in ~/.everos/everos.toml; the README does not document a fully offline (key-less) production mode beyond the educational demo.
2025-10-282026-08-17v1.2.3

Apache-2.0 · actively maintained (latest release v1.2.3, 2026-08-07)

06常见问题

DeepSeek Harness 如何接入 EverOS?

把 EverOS 作为本地记忆服务运行(everos server start),在 dsh 工作流中调用其 HTTP API:/api/v2/memory/add、/api/v2/memory/flush、/api/v2/memory/search。README 将 EverOS 定位为 AI 编码助手的通用长期记忆层,用例区还有多个编码 CLI 集成示例可参考。

安装前需要准备什么?

Python 3.12+ 和一个 OpenRouter API 密钥。如果只想先体验摄入→提取→索引→召回的完整流程,可直接运行 everos demo,无需任何密钥。

记忆数据存在哪里?

全部存在本地 ~/.everos 目录(也可用 everos init --root <path> 指定其他路径),以可读、可编辑的 Markdown 文件持久化,并用本地 SQLite 和 LanceDB 建索引,不需要 MongoDB、Elasticsearch 或 Redis。

单密钥(Tier 1)模式有什么限制?

只覆盖服务启动、记忆写入与 flush、Markdown 持久化、级联索引和关键词检索;混合检索、反思和知识 Wiki 需要额外配置 embedding/rerank 提供商。缺失能力会在 /health 中报告,未配置的功能调用会返回 HTTP 422。

能摄入文档和图片吗?

可以。安装可选的 everos[multimodal] 扩展后支持图片、PDF、音频、HTML、邮件和 Office 文档;其中 Office 格式还要求主机安装 LibreOffice,否则会返回 HTTP 415。

08数据与来源

  • 作者声明github.comd07cddc40304…

    Universal long-term memory layer for AI coding assistants, powered by EverOS.

  • 作者声明github.comd07cddc40304…

    EverOS is a Python library and local-first memory runtime for agents and makers. It gives one portable memory layer acro…

页面基于项目公开文档、仓库元数据和 DSH Plugins 的结构化解析生成;最后核验于 2026-08-21。发现错误?提交更正。

🏆

最佳 DeepSeek Harness 插件

从全目录挑出的 12 个值得优先安装的插件,覆盖各个分类。

DSH Plugins 是独立的 DeepSeek Harness 插件市场,与 DeepSeek 官方无关,也不代表官方背书。第三方插件未经安全审计,安装前请审查源码。

每周获取最新的 DeepSeek Harness 插件,绝不滥发。