Mnemosyne-Neural-OS

<div align="center">

<img src="assets/banner-mnemosyne-os.png" width="100%" alt="Mnemosyne OS — Infinity Edition. Your memory. Your machine. Your rules. A sovereign, local-first memory OS — the relationship layer between you and every AI." />

### The sovereign AI Operating System

**Open to build on · Private at the core**

<img src="assets/flags/en.svg" height="14" alt="English" /> English&ensp;·&ensp;<img src="assets/flags/fr.svg" height="14" alt="Français" /> Français&ensp;·&ensp;<img src="assets/flags/es.svg" height="14" alt="Español" /> Español&ensp;·&ensp;<img src="assets/flags/de.svg" height="14" alt="Deutsch" /> Deutsch&ensp;·&ensp;<img src="assets/flags/br.svg" height="14" alt="Português" /> Português&ensp;·&ensp;<img src="assets/flags/ru.svg" height="14" alt="Русский" /> Русский&ensp;·&ensp;<img src="assets/flags/zh.svg" height="14" alt="中文" /> 中文

<br/>

*Everyone is building the intelligence. Mnemosyne builds the **relationship** — the memory that makes an AI truly know you, across sessions and across time. On your machine. Yours to see.*

[**→ Why the relationship layer**](doc/WHY.md)

<br/>

[![CI](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/actions/workflows/ci.yml/badge.svg)](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/actions)
![TypeScript](https://img.shields.io/badge/TypeScript-strict-3178c6?logo=typescript)
![Electron](https://img.shields.io/badge/Electron-31.7.7-47848f?logo=electron)
![React](https://img.shields.io/badge/React-18-61dafb?logo=react)
![Tests](https://img.shields.io/badge/tests-passing-22c55e)
[![Mnemosyne OS Benchmark](https://img.shields.io/badge/LongMemEval--M-77.1%25_strict_·_verifiable-33ffd6?style=flat-square)](https://mnemosyne-os.github.io/MnemosyneOS---benchmarks/verification-kit/)
![License](https://img.shields.io/badge/license-open--core-8b5cf6)
![Interface languages](https://img.shields.io/badge/interface-7_languages-a98bff)
[![version](https://img.shields.io/github/v/release/Mnemosyne-OS/Mnemosyne-Neural-OS?include_prereleases&label=version&color=f59e0b)](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/releases)

<br/><br/>

<!-- Download + MnemoForge badges: auto-updated by `.github/workflows/sync-readme-release-badges.yml` on Release (tags `v…` = OS setup, `cli-…` = CLI). -->
[![Download Mnemosyne OS](https://img.shields.io/static/v1?label=Download&message=Mnemosyne+OS+%28v1.4.5%29+%C2%B7+NEW&color=111827&logo=github&style=for-the-badge)](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/releases/tag/v1.4.5)
[![MnemoForge CLI](https://img.shields.io/badge/📦_MnemoForge_CLI_(Open_Source)-8b5cf6?style=for-the-badge&logo=npm)](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/releases/tag/cli-v1.3.18)

<br/>

🔏 Every installer above is **cryptographically attested** to this exact repo, workflow
and commit — via [GitHub Artifact Attestations](https://github.com/Mnemosyne-OS/Mnemosyne-Neural-OS/attestations)
(Sigstore-backed build provenance). Don't take the download on faith — verify the file
you got matches what our CI actually built:
```bash
gh attestation verify Mnemosyne-OS-Infinity-Setup-x64.exe -R Mnemosyne-OS/Mnemosyne-Neural-OS
```

<br/>

[![Audit our benchmark yourself](https://img.shields.io/badge/🔍_Don't_trust_it%3F_Audit_the_77.1%25-live_results-33ffd6?style=for-the-badge&labelColor=0b1120)](https://mnemosyne-os.github.io/MnemosyneOS---benchmarks/verification-kit/)
[![Documentation](https://img.shields.io/badge/📖_Documentation-docs.mnemosyne--os.io-8b5cf6?style=for-the-badge&labelColor=0b1120)](https://docs.mnemosyne-os.io)

<br/>

🌐 **[mnemosyne-os.io](https://mnemosyne-os.io)** — the product, for builders&ensp;·&ensp;**[mnemosyne-os.com](https://mnemosyne-os.com)** — the company, press & labs&ensp;·&ensp;📖 **[docs.mnemosyne-os.io](https://docs.mnemosyne-os.io)** — the user guide

<br/>

<img src="assets/strip-specs.png" width="100%" alt="100% local — your memory never leaves your machine · 8 GB RAM — enough to start, fully local from 16 GB · 7 languages — EN FR ES DE PT RU ZH · Windows, macOS, Linux — code-signed builds, auto-update" />

</div>

---

> [!TIP]
> **📖 The user documentation is live: [docs.mnemosyne-os.io](https://docs.mnemosyne-os.io)** — every engine explained step by step, in
> [English](https://docs.mnemosyne-os.io/) · [Français](https://docs.mnemosyne-os.io/fr/) · [Español](https://docs.mnemosyne-os.io/es/).

## 🌍 Fully multilingual — the OS speaks your language

The **entire interface is localized in seven languages** — onboarding, settings,
chat, the voice assistant, every dialog. Switching language even re-selects the
★ recommended embedding model for it, so **retrieval quality follows your
language**, not just the labels. Open windows pick the change up instantly.

| | Language | | Status |
|---|---|---|---|
| <img src="assets/flags/en.svg" width="24" height="16" alt="English flag" /> | **English** | Your memory. Your machine. Your rules. | Stable |
| <img src="assets/flags/fr.svg" width="24" height="16" alt="Drapeau français" /> | **Français** | Ta mémoire. Ta machine. Tes règles. | Stable |
| <img src="assets/flags/es.svg" width="24" height="16" alt="Bandera de España" /> | **Español** | Tu memoria. Tu máquina. Tus reglas. | Stable |
| <img src="assets/flags/de.svg" width="24" height="16" alt="Deutsche Flagge" /> | **Deutsch** | Dein Gedächtnis. Deine Maschine. Deine Regeln. | Beta |
| <img src="assets/flags/br.svg" width="24" height="16" alt="Bandeira do Brasil" /> | **Português** | Sua memória. Sua máquina. Suas regras. | Beta |
| <img src="assets/flags/ru.svg" width="24" height="16" alt="Флаг России" /> | **Русский** | Твоя память. Твоя машина. Твои правила. | Beta |
| <img src="assets/flags/zh.svg" width="24" height="16" alt="中国国旗" /> | **中文** | 你的记忆。你的机器。你的规则。 | Beta |

*Sovereign, local-first memory — in your language: un système d'exploitation de
mémoire souverain et local · un sistema operativo de memoria soberano y local ·
ein souveränes, lokales Gedächtnis-Betriebssystem · um sistema operacional de
memória soberano e local · суверенная локальная операционная система памяти ·
主权的本地优先记忆操作系统.*

---

## Not another agent-memory library

Mem0, Zep and Letta give *agents* a memory layer you wire into a cloud stack.

**Mnemosyne OS is a personal memory OS that runs on your machine** — your data never
leaves it, a human governs it, and it scores **77.1% on LongMemEval-M** ([audit it
yourself](https://mnemosyne-os.github.io/MnemosyneOS---benchmarks/verification-kit/)).

The AI that remembers *you* — not infrastructure you plug into someone else's.

### Where the project lives

Published by **XPACEGEMS LLC**. These are its official addresses:

| | |
|---|---|
| **Product** | [mnemosyne-os.io](https://mnemosyne-os.io) |
| **Organizations** | [mnemosyne-os.com](https://mnemosyne-os.com) |
| **Documentation** | [docs.mnemosyne-os.io](https://docs.mnemosyne-os.io) |
| **Source** | this repository |
| **Packages** | the npm scope `@mnemosyne_os` — [the list](https://mnemosyne-os.io/packages) |

---

## Why call it an "OS"?

Not because it has a kernel or drivers — because it does what an OS does:
**it manages resources on behalf of processes that shouldn't have to manage them
themselves.** Linux does that for programs (CPU, RAM, disk, network). Mnemosyne does
the same thing for **AI agents**, and the resources are just different:

| An agent needs | Mnemosyne manages it via |
|---|---|
| **Memory** | Vaults — SQLite + vector stores, partitioned by domain, with AES-256 encryption at rest you arm |
| **Context** | Chronicles + semantic retrieval — the agent never rebuilds its past by hand |
| **Compute** | Routing across model tiers (budget/standard/premium, local/cloud) by task complexity |
| **Hardware** | Real GPU/CPU dispatch for local speech (CUDA detection, isolated sidecars) so a heavy model never blocks the app |
| **I/O** | A signed intent protocol (query / ingest / forget / focus) instead of raw reads and writes |
| **Security** | FGAC, scoped JWTs, Zero-Trust IPC validation |
| **Persistence** | Cross-session continuity — no cold start on every invocation |

This isn't a marketing stretch invented for this repo. **MemGPT** (Packer et al., UC
Berkeley, 2023, [arXiv:2310.08560](https://arxiv.org/abs/2310.08560)) proposed the same
"OS for LLMs" analogy in a peer-reviewed paper — virtual context management modeled on
OS memory hierarchies. Mnemosyne takes that same premise further: not a single-session
context-paging technique, but a system that runs continuously, isolates multiple agents,
and persists on the machine as a daemon — not a library you import and lose on exit.

---

## The flagship app — Mnemosyne OS Infinity Edition

The reference application of the ecosystem: a **local-first AI Operating System** that
puts a sovereign memory core under strict user control. It runs LLMs locally or in the
cloud, keeps every encrypted vault on your machine, and — for agent-to-agent sync — can
speak over a **libp2p** transport (`@mnemosyne-workspace/mnemosync-p2p`).

Unlike fragmented AI wrappers, Mnemosyne never exposes your knowledge vault
indiscriminately. Every agentic connection is governed by **FGAC (Fine-Grained Access
Control)** and 400 Zod-validated IPC channels, ensuring total sovereignty over what
executes, what's stored, and what syncs.

### Core Modules

| Module | Description |
|--------|-------------|
| 🧭 **Neural Map** | Your memory rendered as a living mathematical topology — nodes are memories, edges are semantic similarity between them, tuned live |
| 🧩 **MnemoHub** | A store of cartridges (mini-apps) whose catalog is signed by a sovereign wallet and verified client-side before anything renders |
| 💤 **Dream State** | A consolidation engine that replays and links memories during idle phases |
| 🗄️ **Vaults** | Memory partitioned by life domain, each with its own protection level and consent boundary |
| 🎙️ **Voice Assistant** | Local or cloud speech, streaming STT/TTS, gaples