Skip to content

EverMind-AI/EverOS

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

636 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation


Important

Project Structure Update

We've unified EverCore, HyperMem, EverMemBench, and EvoAgentBench with usecases into a single repository.

EverOS gives developers one place to build, evaluate, and integrate long-term memory into their self-evolving agents. 🎉


Project Overview

EverOS is a collection of long-term memory methods, benchmarks, and usecases for building self-evolving agents.

EverOS/
└── methods/
    ├── EverCore/            # Long-term memory operating system
    └── HyperMem/            # Hypergraph memory architecture
├── benchmarks/
│   ├── EverMemBench/        # Memory quality evaluation
│   └── EvoAgentBench/       # Agent self-evolution evaluation
└── usecases/                # Example applications

Methods

Methods are production-ready memory architectures that give agents persistent, structured long-term memory. Each can be used standalone or composed together depending on your use case.

banner-gif

EverCore

A self-organizing memory operating system inspired by biological imprinting. Extracts, structures, and retrieves long-term knowledge from conversations — enabling agents to remember, understand, and continuously evolve.

Paper · Docs

banner-gif

HyperMem

A hypergraph-based hierarchical memory architecture that captures high-order associations through hyperedges. Organizes memory into topic, event, and fact layers for coarse-to-fine long-term conversation retrieval. LoCoMo 92.73%.

Paper · Docs


Benchmarks

Benchmarks are designed as open public standards. Any memory architecture or agent framework can be evaluated under the same ruler.

banner-gif

EverMemBench

Three-layer memory quality evaluation: factual recall, applied reasoning, and personalized generalization. Evaluates memory systems and LLMs under a unified standard.

Paper · Dataset · Docs

banner-gif

EvoAgentBench

Agent self-evolution evaluation — not static snapshots, but longitudinal growth curves. Measures transfer efficiency, error avoidance, and skill-hit quality through controlled experiments with and without evolution.

Docs


Use Cases

banner-gif

Earth Online Memory Game

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

banner-gif

Multi‑Agent Orchestration Platform

Golutra is pitched as “beyond the IDE,” a multi-agent workforce rather than a single assistant for engineering teams.

banner-gif

Mobi Is a Companion

An iOS app that lets users create, nurture, and live with a personalized AI “lifeform” companion called Mobi.

banner-gif

AI Wearable with Memory

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

banner-gif

OpenClaw Agent Memory

A 24/7 agent with continuous learning memory that you can carry with you wherever you go.

Agent Memory · Plugin

banner-gif

Live2D Character with Memory

Add long-term memory to your anime character that can talk to you in real-time, powered by TEN Framework.

Code

banner-gif

Computer-Use with Memory

Use computer-use to launch screenshot-based analysis, all stored in your 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

Visualize your stored entities and how they relate. Pure frontend demo — backend integration in progress.

Live Demo


Quick Start

git clone https://github.com/EverMind-AI/EverOS.git
cd EverOS

Then navigate to the component you need:

Component Entry Point
EverCore Build agents with long-term memory methods/everos/
HyperMem Use the hypergraph memory architecture methods/HyperMem/
EverMemBench Evaluate memory system quality benchmarks/EverMemBench/
EvoAgentBench Measure agent self-evolution benchmarks/EvoAgentBench/

Each component has its own installation guide, dependency configuration, and usage examples.

EverCore Quick Start

cd methods/evermemos

# Start Docker services
docker compose up -d

# Install dependencies
curl -LsSf https://astral.sh/uv/install.sh | sh
uv sync

# Configure API keys
cp env.template .env
# Edit .env and set:
#   - LLM_API_KEY (for memory extraction)
#   - VECTORIZE_API_KEY (for embedding/rerank)

# Start server
uv run python src/run.py

# Verify installation
curl http://localhost:1995/health
# Expected response: {"status": "healthy", ...}

Server runs at http://localhost:1995 · Full Setup Guide

Basic Usage

Store and retrieve memories with simple Python code:

import requests

API_BASE = "http://localhost:1995/api/v1"

# 1. Store a conversation memory
requests.post(f"{API_BASE}/memories", json={
    "message_id": "msg_001",
    "create_time": "2025-02-01T10:00:00+00:00",
    "sender": "user_001",
    "content": "I love playing soccer on weekends"
})

# 2. Search for relevant memories
response = requests.get(f"{API_BASE}/memories/search", json={
    "query": "What sports does the user like?",
    "user_id": "user_001",
    "memory_types": ["episodic_memory"],
    "retrieve_method": "hybrid"
})

result = response.json().get("result", {})
for memory_group in result.get("memories", []):
    print(f"Memory: {memory_group}")

More Examples · API Reference · Interactive Demos


Evaluation & Benchmarking

EverCore achieves 93% overall accuracy on the LoCoMo benchmark, outperforming comparable memory systems.

Benchmark Results

EverOS Benchmark Results

Supported Benchmarks

  • LoCoMo — Long-context memory benchmark with single/multi-hop reasoning
  • LongMemEval — Multi-session conversation evaluation
  • PersonaMem — Persona-based memory evaluation

Run Evaluations

# Install evaluation dependencies
uv sync --group evaluation

# Run smoke test (quick verification)
uv run python -m evaluation.cli --dataset locomo --system everos --smoke

# Run full evaluation
uv run python -m evaluation.cli --dataset locomo --system everos

# View results
cat evaluation/results/locomo-everos/report.txt

Full Evaluation Guide · Complete Results


Citation

If EverOS helps your research, please cite:

@article{hu2026evermemos,
  title   = {EverMemOS: A Self-Organizing Memory Operating System for Structured Long-Horizon Reasoning},
  author  = {Chuanrui Hu and Xingze Gao and Zuyi Zhou and Dannong Xu and Yi Bai and Xintong Li and Hui Zhang and Tong Li and Chong Zhang and Lidong Bing and Yafeng Deng},
  journal = {arXiv preprint arXiv:2601.02163},
  year    = {2026}
}

@article{yue2026hypermem,
  title   = {HyperMem: Hypergraph Memory for Long-Term Conversations},
  author  = {Juwei Yue and Chuanrui Hu and Jiawei Sheng and Zuyi Zhou and Wenyuan Zhang and Tingwen Liu and Li Guo and Yafeng Deng},
  journal = {arXiv preprint arXiv:2604.08256},
  year    = {2026}
}

@article{hu2026evaluating,
  title   = {Evaluating Long-Horizon Memory for Multi-Party Collaborative Dialogues},
  author  = {Chuanrui Hu and Tong Li and Xingze Gao and Hongda Chen and Yi Bai and Dannong Xu and Tianwei Lin and Xiaohong Li and Yunyun Han and Jian Pei and Yafeng Deng},
  journal = {arXiv preprint arXiv:2602.01313},
  year    = {2026}
}

🌟 Stay Tuned

star us gif


Contributing

We love open-source energy! Whether you are squashing bugs, shipping features, sharpening docs, or just tossing in wild ideas, every PR moves EverOS forward. Browse Issues to find your perfect entry point, then show us what you have got. Let us build the future of memory together.


Tip

Welcome all kinds of contributions 🎉

Join us in building EverOS better! Every contribution makes a difference, from code to documentation. Share your projects on social media to inspire others!

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

divider divider

Code Contributors

EverOS Contributors

divider divider

Contribution Guidelines

Read our Contribution Guidelines for code standards and Git workflow.

divider divider

License & Citation & Acknowledgments

Apache 2.0Acknowledgments