EverMind-AI/EverOSPublic

One portable memory layer for every AI agent: local-first, Markdown-native, user-owned, and self-evolving across apps, tools, and workflows.

AI summary: A local-first, Markdown-native memory runtime providing persistent context for AI agents across different applications.

Stars
14K
+33 today
Forks
980
Watchers
107
Open issues
20
Open PRs
31
Contributors
~15
Commits
176
Branches
21

PythonApache-2.0Created Oct 28, 2025Last push todayLatest release v1.7.0+52 stars this week+401 this month

Quick answers

What is EverOS?
A local-first, Markdown-native memory runtime providing persistent context for AI agents across different applications.
What does EverOS do?
EverOS acts as a unified, long-term memory layer for AI agents, abstracting away the complexities of context retention and Retrieval-Augmented Generation. It captures interactions and stores them locally using a Markdown-native format, ensuring that user data remains private and easily accessible. The system is designed to be self-evolving, allowing memories to persist and update across various agent sessions, tools, and workflows. By utilizing orthogonal retrieval methods, it allows developers to build agents that maintain continuous context without starting from scratch.
Who is EverOS for?
AI developers, researchers, and makers building agentic systems in Python who require a robust, local, and cross-platform memory solution. It is highly beneficial for projects that demand persistent state and context retention over extended periods. The local-first approach ensures privacy and control over the stored knowledge base.
How do I get started with EverOS?
pip install everos
How popular is EverOS on GitHub?
EverMind-AI/EverOS has 13,956 stars and 980 forks on GitHub, and gained 52 stars in the last 7 days.
What license does EverOS use?
EverMind-AI/EverOS is released under the Apache-2.0 license.

Star history

since Jul 28, 2026
05K10KJul 2026Sep 2026Oct 2026Nov 2026
14K stars as of Nov 21, 2026. Measured daily since Jul 28, 2026; GitHub no longer exposes earlier star timestamps.

Update history

2 recorded
  • Nov 13, 2026New release v1.7.0 (previously v1.5.1).
  • Oct 24, 2026New release v1.5.1 (previously v1.4.1).

Contribution activity

commits per day, last 52 weeks
NovDecJanFebMarAprMayJunJulAugSepOctNovMonWedFri2025-11-16: 0 commits2025-11-17: 0 commits2025-11-18: 0 commits2025-11-19: 0 commits2025-11-20: 0 commits2025-11-21: 0 commits2025-11-22: 0 commits2025-11-23: 0 commits2025-11-24: 0 commits2025-11-25: 0 commits2025-11-26: 0 commits2025-11-27: 0 commits2025-11-28: 0 commits2025-11-29: 0 commits2025-11-30: 0 commits2025-12-01: 0 commits2025-12-02: 0 commits2025-12-03: 0 commits2025-12-04: 0 commits2025-12-05: 0 commits2025-12-06: 0 commits2025-12-07: 0 commits2025-12-08: 0 commits2025-12-09: 0 commits2025-12-10: 0 commits2025-12-11: 0 commits2025-12-12: 0 commits2025-12-13: 0 commits2025-12-14: 0 commits2025-12-15: 0 commits2025-12-16: 0 commits2025-12-17: 0 commits2025-12-18: 0 commits2025-12-19: 0 commits2025-12-20: 0 commits2025-12-21: 0 commits2025-12-22: 0 commits2025-12-23: 0 commits2025-12-24: 0 commits2025-12-25: 0 commits2025-12-26: 0 commits2025-12-27: 0 commits2025-12-28: 0 commits2025-12-29: 0 commits2025-12-30: 0 commits2025-12-31: 0 commits2026-01-01: 0 commits2026-01-02: 0 commits2026-01-03: 0 commits2026-01-04: 0 commits2026-01-05: 0 commits2026-01-06: 0 commits2026-01-07: 0 commits2026-01-08: 0 commits2026-01-09: 0 commits2026-01-10: 0 commits2026-01-11: 0 commits2026-01-12: 0 commits2026-01-13: 0 commits2026-01-14: 0 commits2026-01-15: 0 commits2026-01-16: 0 commits2026-01-17: 0 commits2026-01-18: 0 commits2026-01-19: 0 commits2026-01-20: 0 commits2026-01-21: 0 commits2026-01-22: 0 commits2026-01-23: 0 commits2026-01-24: 0 commits2026-01-25: 0 commits2026-01-26: 0 commits2026-01-27: 0 commits2026-01-28: 0 commits2026-01-29: 0 commits2026-01-30: 0 commits2026-01-31: 0 commits2026-02-01: 0 commits2026-02-02: 0 commits2026-02-03: 0 commits2026-02-04: 0 commits2026-02-05: 0 commits2026-02-06: 0 commits2026-02-07: 0 commits2026-02-08: 0 commits2026-02-09: 0 commits2026-02-10: 0 commits2026-02-11: 0 commits2026-02-12: 0 commits2026-02-13: 0 commits2026-02-14: 0 commits2026-02-15: 0 commits2026-02-16: 0 commits2026-02-17: 0 commits2026-02-18: 0 commits2026-02-19: 0 commits2026-02-20: 0 commits2026-02-21: 0 commits2026-02-22: 0 commits2026-02-23: 0 commits2026-02-24: 0 commits2026-02-25: 0 commits2026-02-26: 0 commits2026-02-27: 0 commits2026-02-28: 0 commits2026-03-01: 0 commits2026-03-02: 0 commits2026-03-03: 0 commits2026-03-04: 0 commits2026-03-05: 0 commits2026-03-06: 0 commits2026-03-07: 0 commits2026-03-08: 0 commits2026-03-09: 0 commits2026-03-10: 0 commits2026-03-11: 0 commits2026-03-12: 0 commits2026-03-13: 0 commits2026-03-14: 0 commits2026-03-15: 0 commits2026-03-16: 0 commits2026-03-17: 0 commits2026-03-18: 0 commits2026-03-19: 0 commits2026-03-20: 0 commits2026-03-21: 0 commits2026-03-22: 0 commits2026-03-23: 0 commits2026-03-24: 0 commits2026-03-25: 0 commits2026-03-26: 0 commits2026-03-27: 0 commits2026-03-28: 0 commits2026-03-29: 0 commits2026-03-30: 0 commits2026-03-31: 0 commits2026-04-01: 0 commits2026-04-02: 0 commits2026-04-03: 0 commits2026-04-04: 0 commits2026-04-05: 0 commits2026-04-06: 0 commits2026-04-07: 0 commits2026-04-08: 0 commits2026-04-09: 0 commits2026-04-10: 0 commits2026-04-11: 0 commits2026-04-12: 0 commits2026-04-13: 0 commits2026-04-14: 0 commits2026-04-15: 0 commits2026-04-16: 0 commits2026-04-17: 0 commits2026-04-18: 0 commits2026-04-19: 0 commits2026-04-20: 0 commits2026-04-21: 0 commits2026-04-22: 0 commits2026-04-23: 0 commits2026-04-24: 0 commits2026-04-25: 0 commits2026-04-26: 0 commits2026-04-27: 0 commits2026-04-28: 0 commits2026-04-29: 0 commits2026-04-30: 0 commits2026-05-01: 0 commits2026-05-02: 0 commits2026-05-03: 0 commits2026-05-04: 0 commits2026-05-05: 0 commits2026-05-06: 0 commits2026-05-07: 0 commits2026-05-08: 0 commits2026-05-09: 0 commits2026-05-10: 0 commits2026-05-11: 0 commits2026-05-12: 0 commits2026-05-13: 0 commits2026-05-14: 0 commits2026-05-15: 0 commits2026-05-16: 0 commits2026-05-17: 0 commits2026-05-18: 0 commits2026-05-19: 0 commits2026-05-20: 0 commits2026-05-21: 0 commits2026-05-22: 0 commits2026-05-23: 0 commits2026-05-24: 0 commits2026-05-25: 0 commits2026-05-26: 0 commits2026-05-27: 0 commits2026-05-28: 0 commits2026-05-29: 0 commits2026-05-30: 0 commits2026-05-31: 0 commits2026-06-01: 0 commits2026-06-02: 0 commits2026-06-03: 0 commits2026-06-04: 0 commits2026-06-05: 1 commit2026-06-06: 9 commits2026-06-07: 2 commits2026-06-08: 0 commits2026-06-09: 1 commit2026-06-10: 0 commits2026-06-11: 0 commits2026-06-12: 0 commits2026-06-13: 0 commits2026-06-14: 0 commits2026-06-15: 1 commit2026-06-16: 2 commits2026-06-17: 3 commits2026-06-18: 1 commit2026-06-19: 0 commits2026-06-20: 0 commits2026-06-21: 0 commits2026-06-22: 0 commits2026-06-23: 7 commits2026-06-24: 4 commits2026-06-25: 3 commits2026-06-26: 0 commits2026-06-27: 0 commits2026-06-28: 0 commits2026-06-29: 1 commit2026-06-30: 0 commits2026-07-01: 0 commits2026-07-02: 0 commits2026-07-03: 1 commit2026-07-04: 0 commits2026-07-05: 0 commits2026-07-06: 0 commits2026-07-07: 1 commit2026-07-08: 1 commit2026-07-09: 0 commits2026-07-10: 1 commit2026-07-11: 0 commits2026-07-12: 0 commits2026-07-13: 1 commit2026-07-14: 1 commit2026-07-15: 0 commits2026-07-16: 0 commits2026-07-17: 0 commits2026-07-18: 0 commits2026-07-19: 0 commits2026-07-20: 0 commits2026-07-21: 0 commits2026-07-22: 0 commits2026-07-23: 4 commits2026-07-24: 8 commits2026-07-25: 0 commits2026-07-26: 0 commits2026-07-27: 1 commit2026-07-28: 5 commits2026-07-29: 4 commits2026-07-30: 2 commits2026-07-31: 0 commits2026-08-01: 0 commits2026-08-02: 0 commits2026-08-03: 1 commit2026-08-04: 2 commits2026-08-05: 3 commits2026-08-06: 0 commits2026-08-07: 5 commits2026-08-08: 0 commits2026-08-09: 0 commits2026-08-10: 0 commits2026-08-11: 1 commit2026-08-12: 0 commits2026-08-13: 1 commit2026-08-14: 1 commit2026-08-15: 1 commit2026-08-16: 0 commits2026-08-17: 1 commit2026-08-18: 0 commits2026-08-19: 0 commits2026-08-20: 0 commits2026-08-21: 0 commits2026-08-22: 0 commits2026-08-23: 0 commits2026-08-24: 0 commits2026-08-25: 1 commit2026-08-26: 1 commit2026-08-27: 0 commits2026-08-28: 0 commits2026-08-29: 0 commits2026-08-30: 0 commits2026-08-31: 0 commits2026-09-01: 2 commits2026-09-02: 0 commits2026-09-03: 1 commit2026-09-04: 1 commit2026-09-05: 0 commits2026-09-06: 0 commits2026-09-07: 4 commits2026-09-08: 4 commits2026-09-09: 0 commits2026-09-10: 0 commits2026-09-11: 0 commits2026-09-12: 0 commits2026-09-13: 0 commits2026-09-14: 0 commits2026-09-15: 0 commits2026-09-16: 0 commits2026-09-17: 0 commits2026-09-18: 0 commits2026-09-19: 0 commits2026-09-20: 0 commits2026-09-21: 0 commits2026-09-22: 0 commits2026-09-23: 0 commits2026-09-24: 15 commits2026-09-25: 0 commits2026-09-26: 0 commits2026-09-27: 0 commits2026-09-28: 0 commits2026-09-29: 0 commits2026-09-30: 1 commit2026-10-01: 1 commit2026-10-02: 0 commits2026-10-03: 0 commits2026-10-04: 0 commits2026-10-05: 0 commits2026-10-06: 0 commits2026-10-07: 0 commits2026-10-08: 0 commits2026-10-09: 1 commit2026-10-10: 1 commit2026-10-11: 0 commits2026-10-12: 3 commits2026-10-13: 1 commit2026-10-14: 4 commits2026-10-15: 4 commits2026-10-16: 1 commit2026-10-17: 0 commits2026-10-18: 0 commits2026-10-19: 0 commits2026-10-20: 4 commits2026-10-21: 5 commits2026-10-22: 2 commits2026-10-23: 0 commits2026-10-24: 0 commits2026-10-25: 0 commits2026-10-26: 0 commits2026-10-27: 0 commits2026-10-28: 0 commits2026-10-29: 0 commits2026-10-30: 1 commit2026-10-31: 0 commits2026-11-01: 0 commits2026-11-02: 0 commits2026-11-03: 1 commit2026-11-04: 1 commit2026-11-05: 8 commits2026-11-06: 9 commits2026-11-07: 0 commits2026-11-08: 0 commits2026-11-09: 2 commits2026-11-10: 1 commit2026-11-11: 4 commits2026-11-12: 1 commit2026-11-13: 3 commits2026-11-14: 0 commits
169 commits in the last yearLessMore

Signals and awards

derived from tracked data
  • Widely adopted

    13,956 stars

  • Actively maintained

    Pushed within 48 hours

  • Well documented

    High community health score

  • Permissive license

    Apache-2.0

  • Continuous integration

    Automated checks passing

What EverOS does

EverOS acts as a unified, long-term memory layer for AI agents, abstracting away the complexities of context retention and Retrieval-Augmented Generation. It captures interactions and stores them locally using a Markdown-native format, ensuring that user data remains private and easily accessible. The system is designed to be self-evolving, allowing memories to persist and update across various agent sessions, tools, and workflows. By utilizing orthogonal retrieval methods, it allows developers to build agents that maintain continuous context without starting from scratch.

AI developers, researchers, and makers building agentic systems in Python who require a robust, local, and cross-platform memory solution. It is highly beneficial for projects that demand persistent state and context retention over extended periods. The local-first approach ensures privacy and control over the stored knowledge base.

  • Local-first privacy: Stores all memory data directly on the user's machine, ensuring complete ownership and security.
  • Markdown-native format: Saves context in plain, readable Markdown files, making the data easily auditable and portable.
  • Continuous persistence: Enables memories to self-evolve and persist indefinitely across multiple independent agent sessions.
  • Orthogonal retrieval: Supports complex querying of memory by specific user IDs, agent IDs, app IDs, or project scopes.
  • Memory abstraction: Handles all RAG processes internally, allowing developers to focus solely on agent logic.
  • Cross-app integration: Allows different AI tools and workflows to seamlessly share and build upon the same memory pool.

Where teams use it

Persistent personal assistants

Powers AI companions that can indefinitely remember user preferences, previous conversations, and ongoing tasks.

Cross-tool context sharing

Enables an agent working in a coding IDE to seamlessly access research context generated by a different agent in a browser.

Workflow state management

Ensures that complex, multi-step agent workflows can be paused and resumed days later without losing critical context.

Simplified RAG implementation

Provides developers with a robust, ready-to-use local backend for retrieval-augmented generation without managing cloud vectors.

Getting started: pip install everos

README

main branch

Table of Contents

Why EverOS

EverOS is a Python library and local-first memory runtime for agents and makers. It gives one portable memory layer across coding assistants, apps, devices, and workflows from day one. It stores conversations, files, and agent trajectories as readable Markdown, then syncs local SQLite and LanceDB indexes for fast retrieval and self-evolving reuse.

Title EverOS Other Agent Memory Libraries
Markdown source of truth ✅ Canonical .md files that are readable, editable, diffable, and Git-versioned ❌ Usually API, vector, graph, dashboard, or database state
Direct file editing ✅ Edit .md files; cascade watcher syncs ❌ Usually SDK, API, dashboard, or backend update paths
Local three-part stack ✅ Markdown + SQLite + LanceDB; no MongoDB, Elasticsearch, or Redis required ❌ Often depends on managed services, vector DBs, graph DBs, or server stacks
User + agent tracks ✅ User episodes/profile and agent cases/skills are separate first-class surfaces ❌ Usually centered on chat history, profiles, entities, facts, or retrieval records
Orthogonal retrieval ✅ Search by user_id, agent_id, app_id, project_id, and session_id ❌ Usually app, namespace, tenant, thread, or graph scoped
Knowledge Wiki ✅ Editable, source-backed Markdown knowledge pages with taxonomy, CRUD APIs, and topic search ❌ Usually separate from memory, trapped in a dashboard, or not tied back to source files
Reflection ✅ Offline memory evolution that merges episode clusters and refines profiles and skills between sessions ❌ Usually retrieval-only memory with little background consolidation or long-horizon improvement

Ecosystem Integrations

EverOS adds durable memory to the agent and workflow platforms below—and comes built into Raven. Choose an integration to open its setup guide.

DeepSeek Harness
DeepSeek Harness
Hermes
Hermes
OpenClaw
OpenClaw
Raven
Raven
Dify
Dify

Quick Start

One OpenRouter API key is enough to start EverOS, write durable memories, and retrieve them with keyword search.

Prerequisites

1. Install

uv pip install everos
# or: pip install everos

2. Try the standalone demo — no key required

No API key or server setup required—run one command to quickly experience how EverOS stores and recalls memory:

# If you installed EverOS as a package:
everos demo

# If you cloned or forked this repository and have not activated .venv:
uv run everos demo

Enter something EverOS should remember, then ask a related question to watch the memory move through ingest -> extract -> index -> recall.

readme.-github.webm

3. Initialize and add your OpenRouter key

everos init

This creates ~/.everos/everos.toml and ~/.everos/ome.toml. Open ~/.everos/everos.toml; it comes pre-filled with a recommended model (see Recommended models) and the OpenRouter URL, so replace only the empty api_key:

[llm]
model = "openai/gpt-4.1-mini"
api_key = "<OPENROUTER_API_KEY>"
base_url = "https://openrouter.ai/api/v1"

This is the smallest Tier 1 setup: memory add, flush, Markdown persistence, cascade indexing, and keyword search.

Use everos init --root <path> if you want a different memory root. Pass the same --root <path> to subsequent commands.

4. Start EverOS

everos server start

Keep the server running, then open a second terminal and check it:

curl http://127.0.0.1:8000/health

Look for "status":"ok". With this one-key setup, capabilities.embed and capabilities.rerank remain false until you configure them.

5. Add and retrieve your first memory

Note

Business endpoints live under /api/v2. The older /api/v1 prefix still resolves to the same handlers so existing integrations keep working, but it is a legacy alias that may be removed in a future major release — write new code against /api/v2.

Add a tiny conversation:

TS=$(($(date +%s)*1000))

curl -X POST http://127.0.0.1:8000/api/v2/memory/add \
  -H 'Content-Type: application/json' \
  -d "{
    \"session_id\": \"demo-001\",
    \"app_id\": \"default\",
    \"project_id\": \"default\",
    \"messages\": [
      {\"sender_id\": \"alice\", \"role\": \"user\", \"timestamp\": $TS, \"content\": \"I love climbing in Yosemite every spring.\"},
      {\"sender_id\": \"alice\", \"role\": \"user\", \"timestamp\": $((TS+10000)), \"content\": \"My favorite coffee shop is Blue Bottle in SOMA.\"}
    ]
  }"

Flush the memory at the end of the session:

curl -X POST http://127.0.0.1:8000/api/v2/memory/flush \
  -H 'Content-Type: application/json' \
  -d '{"session_id":"demo-001","app_id":"default","project_id":"default"}'

Search it back:

curl -X POST http://127.0.0.1:8000/api/v2/memory/search \
  -H 'Content-Type: application/json' \
  -d '{
    "user_id": "alice",
    "app_id": "default",
    "project_id": "default",
    "query": "Where do I like to climb?",
    "method": "keyword",
    "top_k": 5
  }'

You should see the Yosemite memory in the response. Keep "method": "keyword" in this one-key setup because the API defaults to hybrid search, which requires an embedding provider.

Tip

First memory unlocked. You just gave EverOS a fact, flushed it into durable Markdown-backed memory, and searched it back through the local index. That is the core loop. Want to see the source of truth? Open ~/.everos and inspect the generated Markdown files.

For annotated responses and the Markdown files EverOS creates, see QUICKSTART.md.

What works with one key?

The OpenRouter one-key setup is EverOS Tier 1. It supports server startup, memory add and flush, durable Markdown storage, cascade indexing, and keyword search. Add optional providers only when you need the features below:

Configuration Adds
[llm] only Core memory flow and keyword search
Add [embedding] Vector/user hybrid search, reflection, and skill extraction
Add [rerank] too Agentic search, default agent hybrid search, and Knowledge Wiki
Add [multimodal] and parser extra Image, PDF, audio, and office-file ingestion

Missing optional capabilities are reported by /health and return a clear HTTP 422 if you request a feature that needs them.

Note

everos demo --live is different from the standalone demo in step 2: it connects to a running server and uses the real add/flush/search flow. It uses hybrid search, so add an embedding provider before you run it.

Recommended models

The generated everos.toml pre-fills these (all but the decider); any OpenAI-compatible model can replace them.

Role Section Recommended model
Memory extraction [llm] openai/gpt-4.1-mini
Retrieval decider for llm_multiround search [llm.decider] qwen3.6-27B or deepseek/deepseek-v4-flash-0731; left empty, the [llm] model decides
Embedding [embedding] Qwen/Qwen3-Embedding-4B
Rerank [rerank] Qwen/Qwen3-Reranker-4B
Multimodal parsing [multimodal] google/gemini-3.8-flash

The extraction model and the deciders above produced our published benchmark results; benchmarks/README.md lists which model ran in which role for each benchmark, and how to reproduce them.

Optional: Ingest Multimodal Files

To ingest non-text content (image / pdf / audio / office documents) through /api/v2/memory/add content items, install the optional extra:

uv pip install 'everos[multimodal]'   # or: pip install 'everos[multimodal]'

This adds the parser's [svg] bundle for SVG support via cairosvg; the base parser is already required by knowledge ingestion. Configure the [multimodal] section in everos.toml; it comes pre-filled with the recommended model, google/gemini-3.8-flash via OpenRouter.

Office document support requires LibreOffice as a system dependency. The parser shells out to soffice (LibreOffice's headless renderer) to convert .doc / .docx / .ppt / .pptx / .xls / .xlsx to PDF before feeding the result into the multimodal LLM. Without LibreOffice, office uploads return HTTP 415 with a clear error message; PDF / image / audio / HTML / email parsing is unaffected.

Install on the host before serving office documents:

brew install --cask libreoffice              # macOS
sudo apt-get install -y libreoffice          # Debian / Ubuntu

For Contributors

git clone https://github.com/EverMind-AI/EverOS.git
cd EverOS
uv sync                              # creates ./.venv and installs deps
uv run everos demo --plain           # try the local educational demo; no API keys needed
uv run everos init                   # add one OpenRouter key to ~/.everos/everos.toml

uv run everos --help
make test

Use Cases

Now that you have had your first successful EverOS moment, explore what people are building with persistent memory across agents, apps, and community integrations.

Use cases show what persistent memory makes possible in real products and workflows. Some examples are packaged in this repository; others point to external demos or integrations you can study and adapt.

AIUI Sports Agents for Smart Glasses

AIUI Sports Agents

Sports agents for smart glasses, covering running, cycling, and indoor rowing. AISmartRun includes an optional memory-backend contract for post-run summaries; connecting it to EverOS requires a separately configured backend.

Code

banner-gif

Reunite - Find With EverOS

Parents describe what they remember. Children describe what they recall. Reunite uses semantic memory to surface the connections.

Learn more

banner-gif

Hive Orchestrator

Browser-native hive-mind for CLI coding agents - Claude Code, Codex, Gemini, and OpenCode collaborate as real PTY processes via a team protocol.

Code

banner-gif

MCP Server for AI Coding Assistants

Plug EverOS memory into Claude Code, Codex, Claude Desktop or Cursor with uvx everos-mcp. Works with EverOS Cloud and with this self-hosted server.

Code · Setup guide

banner-gif

AI Data Technician

An agentic AI system that learns from scientist interaction to inspect, analyze, and classify high-dimensional time series data - with persistent memory that improves across sessions.

Code

banner-gif

Rokid AI Assistant With EverOS

Connect to EverOS within Rokid Glasses enabling long-term memory for all of your smart activities.

Coming soon

Back to top

banner-gif

Creative Assistant With Memory

Creative assistant with long-term memory, so your creative context stays available across sessions.

Coming soon

banner-gif

Earth Online Memory Game

Earth Online is a memory-aware productivity game that turns everyday planning into a living quest log.

Code

banner-gif

Multi-Agent Orchestration Platform

Golutra presents a multi-agent workforce for engineering teams, extending the IDE model from a single assistant to coordinated agents.

Code

banner-gif

Your Personal Tasting Universe

Record, visualize, and explore your tasting journey through an immersive 3D star map.

Code

banner-gif

EverOS Open Her

Build AI that feels. Open-source persona engine - personality emerges from neural drives, not prompts. Inspired by Her.

Code

banner-gif

Browser Agent For Personal Memory

Ruminer brings persistent memory to a browser agent so it can carry personal context across web tasks.

Plugin

Back to top

banner-gif

EverMem Sync With EverOS

One command to connect any AI coding CLI to EverOS (formerly called EverMemOS) for long-term memory.

Code

banner-gif

MCO - Orchestrate AI Coding Agents

MCO equips your primary agent with an agent team that can work together to solve complex tasks.

Code

banner-gif

Study Buddy With Self-Evolving Memory

Study proactively with an agent that has self-evolving memory.

Code

banner-gif

Alzheimer's Memory Assistant

Empowering individuals with advanced memory support and daily assistance.

Code

banner-gif

Memory-Driven Multi-Agent NPC Experience

An iOS sci-fi mystery game where players explore and uncover the truth.

Code

banner-gif

Mobi Companion

An iOS app where users create, nurture, and live with a personalized AI companion called Mobi.

Code

Back to top

banner-gif

AI Wearable With Memory

A context-native AI wearable that listens to everyday life and converts conversations into memory.

Code

banner-gif

Legacy OpenClaw Agent Memory

Archived pre-1.0.0 plugin reference. New integrations should use the current EverOS API.

Learn more

banner-gif

Live2D Character With Memory

Add long-term memory to a real-time Live2D character, powered by TEN Framework.

Code

banner-gif

Computer-Use With Memory

Run screenshot-based analysis with computer-use and store the results in memory.

Live Demo

banner-gif

Game Of Thrones Memories

A demonstration of AI memory infrastructure through an interactive Q&A experience with A Game of Thrones.

Code

banner-gif

Claude Code Plugin

Persistent memory for Claude Code. Automatically saves and recalls context from past coding sessions.

Code

banner-gif

Memory Graph Visualization

Explore stored entities and relationships in a graph interface. Frontend demo; backend integration is in progress.

Live Demo


Documentation


EverMind Ecosystem

EverMind connects memory research, production-ready products, and practical integrations into one open-source ecosystem.

Products
EverOS A local-first, Markdown-native long-term memory runtime for agents and users.
Raven A memory-first, self-improving agent harness with proactivity, context control, and skill evolution.
EverMe (CLI) A CLI and agent plugin suite for cross-device, cross-agent personal memory.
Research & Evaluation
SkillCorpus Curated, retrieval-ready agent skill corpora with retrieval and evaluation tooling.
EverAlgo Stateless extraction, ranking, parsing, and memory operators that power EverOS.
HyperMem Hypergraph-based hierarchical memory for coarse-to-fine long-term conversation retrieval.
MSA Memory Sparse Attention for scalable latent memory and 100M-token contexts.
EverMemBench Evaluation of factual recall, applied reasoning, and personalized generalization in memory systems.
EvoAgentBench Longitudinal evaluation of agent self-evolution, transfer efficiency, error avoidance, and skill use.
Integrations
OpenClaw OpenClaw plugin for automatic recall, capture, and session-memory lifecycle management.
Hermes Agent Hermes plugin for persistent memory across Hermes sessions.
DeepSeek Harness DSH plugin for memory-aware DeepSeek Harness agents.
Dify Self-hosted and cloud tools for explicit memory search and storage in workflows and agents.

Together, these projects form EverMind's research-to-runtime stack: methods and benchmarks become reusable memory infrastructure, products, and agent integrations.



Contributing

Contributions are welcome across the whole repository: memory methods, benchmark coverage, use-case examples, documentation, and bug fixes. Browse Issues to find a good entry point, then open a PR when you are ready.


Tip

Welcome all kinds of contributions 🎉

Help make EverOS better. Code, documentation, benchmark reports, use-case write-ups, and integration examples are all valuable. Share your projects on social media to inspire others.

Connect with one of the EverOS maintainers @ElliotChen on 𝕏 or @cyfyifanchen on GitHub for project updates, discussions, and collaboration opportunities.

divider divider

Code Contributors

EverOS Contributors

divider divider

License

Apache License 2.0 — see NOTICE for third-party attributions.

Citation

If you use EverOS in research, see CITATION.md.


View on GitHub

Recent activity

commits and pull requests

Releases and announcements

25 total
  1. EverOS 1.7.0v1.7.0Nov 13, 2026

    ## Highlights - **Purge API**: clear the whole memory root, one app or one project while the server keeps serving. No more stopping the server to delete files; other apps and projects keep reading and writing during a purge. - `POST /api/v2/memory/purge`: start a purge. - `POST /api/v2/memory/purge/confirm`: confirm it before anything is deleted, so nothing goes by mistake. - `GET /api/v2/memory/purge/{job_id}`: check its progress. - **User profile built from episodes**: every profile item cites the conversation it comes from, so each fact can be traced to its source. - `user.md` gains a `do_not_record` list: what the user asked not to be remembered stays out of the profile, even when it comes up again. - `user.md` gains a `pending` list: information seen only once waits here until a later conversation confirms it, which cuts down on wrong entries. - **Scenario-based LLM settings** (`[llm.<task>]`): give each scenario, such as boundary detection, profile extraction or the retrieval decider, its own model and parameters; anything left out follows `[llm]`. Use a small, cheap model for simple steps and a larger one where quality matters. - **`[boundary_detection] strategy`*

  2. EverOS 1.6.0v1.6.0Nov 11, 2026

    EverOS 1.6.0 adds memory deletion aligned with the Cloud API, including owner-scoped deletion by ID, and improves recovery when writes, background tasks, and file updates overlap. It also unifies application assembly across the server and CLI through `MemoryService`, `KnowledgeService`, and `OpsService`. This release adds safeguards for large search workloads and keeps unused vectors out of returned query results. See the upgrade notes below for configuration and Python API changes. ## Added - **`POST /api/v2/memory/delete`** ([#483](https://github.com/EverMind-AI/EverOS/issues/483)): delete by `user_id` / `agent_id`, by `session_id`, or one owner's session; answers `{"filters": [...], "count": N}`. A session still being memorized answers `503 SESSION_BUSY` and nothing is deleted. everos-mcp's `forget_session` now works against a self-hosted server. - **`POST /api/v2/memory/delete_by_ids`**: delete episodes by memory id, with what Reflection merged into them, their atomic facts and their cluster membership. The optional `user_id` restricts deletion to that owner; `deleted` reports the number actually removed, excluding missing, duplicate, or

  3. EverOS 1.6.0rc1v1.6.0rc1Nov 11, 2026pre-release

    EverOS 1.6.0rc1 is the release candidate for 1.6.0. It adds memory deletion aligned with the Cloud API, including owner-scoped deletion by ID, and improves recovery when writes, background tasks, and file updates overlap. The server and CLI share application assembly through the same service facades. The complete change list and configuration/Python API upgrade notes are in the [1.6.0 changelog](https://github.com/EverMind-AI/EverOS/blob/v1.6.0rc1/CHANGELOG.md#160---2026-11-11). ## Known limitations - Profile extraction can miss a newly saved conversation if it runs before the asynchronous episode index catches up. The conversation and extracted memories remain searchable; a later conversation may refresh the profile. This also exists in 1.5.1 and is deferred to 1.6.1. - Agent case and skill extraction can overstate an unverified outcome as successful. One smoke-test trajectory exhibited this with the default correctness gate disabled. Review generated procedural memories against their source evidence. ## Upgrade ```bash pip install --upgrade --pre everos==1.6.0rc1 ``` For uv, allow pre-release dependencies explicitly: ```bash uv pip install --prerelease=al

  4. EverOS 1.5.1v1.5.1Oct 22, 2026

    **Hybrid and vector search keep up with 10 requests a second out of the box.** Each of those searches embeds its query first, and the slots reserved for those calls were the limit: with 4 of them and a remote embedding endpoint answering in about 0.45 s, search topped out near 9 requests a second and a steady 10 queued without bound. The default is now 16, which held the same load at a p50 of 0.42 s and a p95 of 1.45 s. ## Changed - **`[embedding].query_max_concurrent` defaults to 16 instead of 4.** Every hybrid or vector search makes one query embedding call, and the budget reserved for those calls bounded search throughput: with a remote endpoint answering in about 0.45 s, 4 slots capped hybrid search near 9 requests/s, so a steady 10 requests/s queued without bound (10,020 indexed entries, 5 minutes: p50 64 s, p95 101 s). At 16 the same load held p50 0.42 s, p95 1.45 s, p99 2.11 s, all 3,000 requests served at 9.99/s. In-flight requests to the endpoint can now reach `max_concurrent + 16`; set it lower if the endpoint is rate-limited. ## Upgrade ```bash pip install --upgrade everos # or: uv sync ``` Nothing to migrate. One thing to

  5. EverOS 1.5.0v1.5.0Oct 21, 2026

    **`/add` no longer has to wait for extraction, and an index can no longer be wrong without saying so.** A client can hand a batch to `/add` with `async_mode` and get a `202` back in milliseconds, while a durable in-process queue runs extraction in session order; the field, the response body and the task-status paths match EverOS Cloud, so one client works against both. Vector columns now follow `[embedding] dim` instead of a hardcoded 1024, startup refuses an index the configured model cannot have produced instead of accepting writes that are truncated or searches that quietly return nothing, and an emptied index is reported instead of looking healthy. The rest is reliability: OME writes no longer starve one another on Windows, a session lock timeout no longer strands a memcell without its episode, a message the model can never segment no longer blocks its session, resolving a cluster's members no longer reads two embedding vectors per member, and a dozen smaller faults found by property-based tests are fixed. ## Added - **`async_mode` on `/add`: accept now, extract in the background.** A request with `async_mode: true` is written to a durable SQLite queue (`m

Code frequency

additions and deletions
+165.8K-165.8KWeek of 2026-05-31: +165,825 linesWeek of 2026-05-31: -2,945 linesWeek of 2026-06-07: +323 linesWeek of 2026-06-07: -5 linesWeek of 2026-06-14: +1,791 linesWeek of 2026-06-14: -443 linesWeek of 2026-06-21: +24,390 linesWeek of 2026-06-21: -4,702 linesWeek of 2026-06-28: +401 linesWeek of 2026-06-28: -69 linesWeek of 2026-07-05: +5,450 linesWeek of 2026-07-05: -5,481 linesWeek of 2026-07-12: +850 linesWeek of 2026-07-12: -91 linesWeek of 2026-07-19: +4,961 linesWeek of 2026-07-19: -1,123 linesWeek of 2026-07-26: +25,351 linesWeek of 2026-07-26: -1,263 linesWeek of 2026-08-02: +83,977 linesWeek of 2026-08-02: -48,783 linesWeek of 2026-08-09: +5,950 linesWeek of 2026-08-09: -1,165 linesWeek of 2026-08-16: +3,731 linesWeek of 2026-08-16: -4 linesWeek of 2026-08-23: +96 linesWeek of 2026-08-23: -3,643 linesWeek of 2026-08-30: +44 linesWeek of 2026-08-30: -8 linesWeek of 2026-09-06: +22,091 linesWeek of 2026-09-06: -2,150 linesWeek of 2026-09-13: +0 linesWeek of 2026-09-13: -0 linesWeek of 2026-09-20: +3,124 linesWeek of 2026-09-20: -205 linesWeek of 2026-09-27: +145 linesWeek of 2026-09-27: -31 linesWeek of 2026-10-04: +7 linesWeek of 2026-10-04: -11 linesWeek of 2026-10-11: +5,031 linesWeek of 2026-10-11: -1,834 linesWeek of 2026-10-18: +14,830 linesWeek of 2026-10-18: -420 linesWeek of 2026-10-25: +74,494 linesWeek of 2026-10-25: -66,498 linesWeek of 2026-11-01: +16,637 linesWeek of 2026-11-01: -783 linesWeek of 2026-11-08: +25,771 linesWeek of 2026-11-08: -4,321 linesMay 31, 2026Nov 8, 2026
+485.3K lines added, -146K removed over the last year.

Commits per week

last 52 weeks
190Week of 2025-11-16: 0 commitsWeek of 2025-11-23: 0 commitsWeek of 2025-11-30: 0 commitsWeek of 2025-12-07: 0 commitsWeek of 2025-12-14: 0 commitsWeek of 2025-12-21: 0 commitsWeek of 2025-12-28: 0 commitsWeek of 2026-01-04: 0 commitsWeek of 2026-01-11: 0 commitsWeek of 2026-01-18: 0 commitsWeek of 2026-01-25: 0 commitsWeek of 2026-02-01: 0 commitsWeek of 2026-02-08: 0 commitsWeek of 2026-02-15: 0 commitsWeek of 2026-02-22: 0 commitsWeek of 2026-03-01: 0 commitsWeek of 2026-03-08: 0 commitsWeek of 2026-03-15: 0 commitsWeek of 2026-03-22: 0 commitsWeek of 2026-03-29: 0 commitsWeek of 2026-04-05: 0 commitsWeek of 2026-04-12: 0 commitsWeek of 2026-04-19: 0 commitsWeek of 2026-04-26: 0 commitsWeek of 2026-05-03: 0 commitsWeek of 2026-05-10: 0 commitsWeek of 2026-05-17: 0 commitsWeek of 2026-05-24: 0 commitsWeek of 2026-05-31: 10 commitsWeek of 2026-06-07: 3 commitsWeek of 2026-06-14: 7 commitsWeek of 2026-06-21: 14 commitsWeek of 2026-06-28: 2 commitsWeek of 2026-07-05: 3 commitsWeek of 2026-07-12: 2 commitsWeek of 2026-07-19: 12 commitsWeek of 2026-07-26: 12 commitsWeek of 2026-08-02: 11 commitsWeek of 2026-08-09: 4 commitsWeek of 2026-08-16: 1 commitsWeek of 2026-08-23: 2 commitsWeek of 2026-08-30: 4 commitsWeek of 2026-09-06: 8 commitsWeek of 2026-09-13: 0 commitsWeek of 2026-09-20: 15 commitsWeek of 2026-09-27: 2 commitsWeek of 2026-10-04: 2 commitsWeek of 2026-10-11: 13 commitsWeek of 2026-10-18: 11 commitsWeek of 2026-10-25: 1 commitsWeek of 2026-11-01: 19 commitsWeek of 2026-11-08: 11 commitsNov 16, 2025Nov 8, 2026
169 commits in the last 52 weeks.

When work happens

weekday and hour
SunMonTueWedThuFriSat036912151821Sun 0:00 — 0 commitsSun 1:00 — 0 commitsSun 2:00 — 0 commitsSun 3:00 — 0 commitsSun 4:00 — 0 commitsSun 5:00 — 0 commitsSun 6:00 — 0 commitsSun 7:00 — 0 commitsSun 8:00 — 1 commitsSun 9:00 — 0 commitsSun 10:00 — 0 commitsSun 11:00 — 0 commitsSun 12:00 — 0 commitsSun 13:00 — 0 commitsSun 14:00 — 0 commitsSun 15:00 — 0 commitsSun 16:00 — 1 commitsSun 17:00 — 0 commitsSun 18:00 — 0 commitsSun 19:00 — 0 commitsSun 20:00 — 0 commitsSun 21:00 — 0 commitsSun 22:00 — 0 commitsSun 23:00 — 0 commitsMon 0:00 — 0 commitsMon 1:00 — 0 commitsMon 2:00 — 0 commitsMon 3:00 — 0 commitsMon 4:00 — 0 commitsMon 5:00 — 0 commitsMon 6:00 — 0 commitsMon 7:00 — 1 commitsMon 8:00 — 0 commitsMon 9:00 — 0 commitsMon 10:00 — 1 commitsMon 11:00 — 3 commitsMon 12:00 — 0 commitsMon 13:00 — 0 commitsMon 14:00 — 0 commitsMon 15:00 — 1 commitsMon 16:00 — 1 commitsMon 17:00 — 2 commitsMon 18:00 — 0 commitsMon 19:00 — 5 commitsMon 20:00 — 0 commitsMon 21:00 — 1 commitsMon 22:00 — 0 commitsMon 23:00 — 0 commitsTue 0:00 — 0 commitsTue 1:00 — 0 commitsTue 2:00 — 0 commitsTue 3:00 — 0 commitsTue 4:00 — 0 commitsTue 5:00 — 0 commitsTue 6:00 — 0 commitsTue 7:00 — 0 commitsTue 8:00 — 0 commitsTue 9:00 — 0 commitsTue 10:00 — 3 commitsTue 11:00 — 2 commitsTue 12:00 — 0 commitsTue 13:00 — 0 commitsTue 14:00 — 2 commitsTue 15:00 — 0 commitsTue 16:00 — 2 commitsTue 17:00 — 1 commitsTue 18:00 — 5 commitsTue 19:00 — 5 commitsTue 20:00 — 6 commitsTue 21:00 — 5 commitsTue 22:00 — 3 commitsTue 23:00 — 0 commitsWed 0:00 — 0 commitsWed 1:00 — 0 commitsWed 2:00 — 0 commitsWed 3:00 — 0 commitsWed 4:00 — 0 commitsWed 5:00 — 0 commitsWed 6:00 — 0 commitsWed 7:00 — 1 commitsWed 8:00 — 1 commitsWed 9:00 — 0 commitsWed 10:00 — 4 commitsWed 11:00 — 2 commitsWed 12:00 — 0 commitsWed 13:00 — 3 commitsWed 14:00 — 4 commitsWed 15:00 — 2 commitsWed 16:00 — 1 commitsWed 17:00 — 3 commitsWed 18:00 — 1 commitsWed 19:00 — 1 commitsWed 20:00 — 3 commitsWed 21:00 — 1 commitsWed 22:00 — 1 commitsWed 23:00 — 3 commitsThu 0:00 — 0 commitsThu 1:00 — 1 commitsThu 2:00 — 0 commitsThu 3:00 — 0 commitsThu 4:00 — 0 commitsThu 5:00 — 0 commitsThu 6:00 — 0 commitsThu 7:00 — 0 commitsThu 8:00 — 1 commitsThu 9:00 — 0 commitsThu 10:00 — 0 commitsThu 11:00 — 0 commitsThu 12:00 — 0 commitsThu 13:00 — 1 commitsThu 14:00 — 2 commitsThu 15:00 — 8 commitsThu 16:00 — 11 commitsThu 17:00 — 8 commitsThu 18:00 — 2 commitsThu 19:00 — 3 commitsThu 20:00 — 4 commitsThu 21:00 — 2 commitsThu 22:00 — 0 commitsThu 23:00 — 0 commitsFri 0:00 — 0 commitsFri 1:00 — 0 commitsFri 2:00 — 0 commitsFri 3:00 — 0 commitsFri 4:00 — 0 commitsFri 5:00 — 0 commitsFri 6:00 — 0 commitsFri 7:00 — 0 commitsFri 8:00 — 2 commitsFri 9:00 — 0 commitsFri 10:00 — 0 commitsFri 11:00 — 4 commitsFri 12:00 — 0 commitsFri 13:00 — 3 commitsFri 14:00 — 5 commitsFri 15:00 — 6 commitsFri 16:00 — 10 commitsFri 17:00 — 0 commitsFri 18:00 — 0 commitsFri 19:00 — 1 commitsFri 20:00 — 0 commitsFri 21:00 — 0 commitsFri 22:00 — 2 commitsFri 23:00 — 0 commitsSat 0:00 — 0 commitsSat 1:00 — 0 commitsSat 2:00 — 0 commitsSat 3:00 — 0 commitsSat 4:00 — 0 commitsSat 5:00 — 0 commitsSat 6:00 — 0 commitsSat 7:00 — 0 commitsSat 8:00 — 1 commitsSat 9:00 — 0 commitsSat 10:00 — 1 commitsSat 11:00 — 1 commitsSat 12:00 — 0 commitsSat 13:00 — 1 commitsSat 14:00 — 2 commitsSat 15:00 — 0 commitsSat 16:00 — 1 commitsSat 17:00 — 0 commitsSat 18:00 — 1 commitsSat 19:00 — 1 commitsSat 20:00 — 0 commitsSat 21:00 — 2 commitsSat 22:00 — 0 commitsSat 23:00 — 0 commits
Commit volume by weekday and hour (UTC). Larger dots mean more commits.
DateListRankStars gained
May 30, 2026daily#24+61
  • public-apis/public-apis

    A collective list of free APIs

    500.5K stars · Python

  • morluto/rea

    Reverse engineer anything with agents, from app behavior down to native binaries.

    471.6K stars · TypeScript

  • openclaw/openclaw

    The AI that really does things. Any OS. Any Platform. The lobster way. 🦞

    394.9K stars · TypeScript

  • donnemartin/system-design-primer

    Learn how to design large-scale systems. Prep for the system design interview. Includes Anki flashcards.

    378.7K stars · Python

  • obra/superpowers

    An agentic skills framework & software development methodology that works.

    322.9K stars · Shell

  • affaan-m/ECC

    The agent harness performance optimization system. Skills, instincts, memory, security, and research-first development for Claude Code, Codex, Opencode, Cursor and beyond.

    307.9K stars · JavaScript