@@ -63,11 +56,11 @@
## Why Ever OS
-EverOS is the local memory operating system for agents and makers. It gives
-one portable memory layer across coding assistants, apps, devices, and
-workflows. Today it stores conversations, files, and agent trajectories as
-readable Markdown, then syncs local SQLite and LanceDB indexes for fast
-retrieval and self-evolving reuse.
+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.
@@ -100,16 +93,6 @@ retrieval and self-evolving reuse.
✅ Search by user_id, agent_id, app_id, project_id, and session_id |
❌ Usually app, namespace, tenant, thread, or graph scoped |
-
-| Knowledge Wiki |
-✅ Coming next: editable, source-backed Markdown knowledge pages built from memory |
-❌ Usually retrieval, graph, dashboards, or generated summaries instead of editable source-backed pages |
-
-
-| Reflection |
-✅ Coming next: Reflection that runs when the system is idle or offline to connect signals, compress history, and improve profiles and skills between sessions |
-❌ Usually online read/write APIs, retrieval records, or summaries rather than idle-time memory consolidation |
-
@@ -122,7 +105,8 @@ retrieval and self-evolving reuse.
## Quick Start
-> Goal: start EverOS, write one memory, and search it back.
+> Goal: play with the memory visualizer first, then start EverOS, write one
+> real memory, and search it back.
### 0. Prerequisites
@@ -138,7 +122,43 @@ uv pip install everos
# or: pip install everos
```
-### 2. Configure
+### 2. Play With The Demo
+
+Run this before configuring API keys or starting the server:
+
+```bash
+everos demo
+```
+
+The command asks for one memory and one recall question, then opens a
+full-screen terminal UI. This is an educational visualizer: it is hardcoded,
+local to the CLI, and does not connect to the EverOS server. Its job is to make
+the memory lifecycle visible: conversation -> memory sphere -> recall -> source
+proof -> confetti. See [docs/everos-demo.md](docs/everos-demo.md) for the demo
+scope and TUI source layout.
+
+The sphere moves through ingest, extraction, indexing, recall, source reveal,
+and a confetti burst after the first memory lands. Press `r` to replay and `q`
+to quit. The optimized animated preview is externally hosted so the repository
+stays light:
+
+
+ 
+
+
+For the looping showroom view used in README media, run:
+
+```bash
+everos demo --cinematic
+```
+
+If your shell is not interactive, or you want a copyable preview, use:
+
+```bash
+everos demo --plain
+```
+
+### 3. Configure
Generate a starter `.env` file, then fill the four API key slots shown in the
generated comments. Only two distinct keys are needed with the defaults:
@@ -153,7 +173,7 @@ cp .env.example .env
`everos init` writes `./.env` by default. Use `everos init --xdg` to
write `${XDG_CONFIG_HOME:-~/.config}/everos/.env` instead.
-### 3. Start EverOS
+### 4. Start EverOS
```bash
everos server start
@@ -177,7 +197,7 @@ The endpoint stack is OpenAI-protocol compatible (OpenAI / OpenRouter / vLLM /
Ollama / DeepInfra) - override `*__BASE_URL` in the generated `.env` to point
at any of them.
-### 4. Try Your First Memory
+### 5. Try Your First Memory
Add a tiny conversation:
@@ -541,7 +561,7 @@ A context-native AI wearable that listens to everyday life and converts conversa
#### Legacy OpenClaw Agent Memory
-Archived pre-1.0.0 plugin reference. New integrations should use the EverOS 1.0.0 API.
+Archived pre-1.0.0 plugin reference. New integrations should use the current EverOS API.
[Learn more](docs/migration-to-1.0.0.md)
@@ -615,115 +635,15 @@ Explore stored entities and relationships in a graph interface. Frontend demo; b
-
-[](#readme-top)
-
-
-
-## Storage Layout
-
-```
-~/.everos/
-├── default_app/ # app_id ("default" → "default_app" on disk)
-│ └── default_project/ # project_id ("default" → "default_project")
-│ ├── users/