{"data":{"slug":"claudiodrews-memory-os","name":"memory-os","tagline":"A 7-layer memory operating system for Hermes Agent with persistent memory and context injection","github_url":"https://github.com/ClaudioDrews/memory-os","owner":"ClaudioDrews","repo":"memory-os","owner_avatar_url":"https://avatars.githubusercontent.com/u/242654945?v=4","primary_language":"Python","stars":1332,"forks":124,"topics":["ai-memory","context-injection","docker","ground-truth","hermes-agent","local-first","open-source","persistent-memory","qdrant","rag","self-hosted","vector-database"],"archived":false,"github_pushed_at":"2026-06-10T10:40:43+00:00","maintenance_label":"Steady","stars_delta_30d":41,"url":"https://www.graphcanon.com/tools/claudiodrews-memory-os","markdown_url":"https://www.graphcanon.com/tools/claudiodrews-memory-os.md","api_url":"https://www.graphcanon.com/api/graphcanon/tools/claudiodrews-memory-os","graph_url":"https://www.graphcanon.com/api/graphcanon/graph?tool=claudiodrews-memory-os","description":"A 7-layer memory operating system for Hermes Agent — persistent memory with Qdrant, structured facts, fabric recall, auto-curated wiki, and surgical context injection. Runs locally, any LLM provider.","homepage_url":null,"license":"MIT","open_issues":9,"watchers":15,"ai_summary":"Provides a memory operating system that supports local-first, self-hosted persistent storage of structured facts using Qdrant as the vector database. Supports integration with any LLM provider.","readme_excerpt":"# Memory OS — Hermes Agent Memory Operating System\n\n\n\n> **Your agent finally stops forgetting.**  \\\n> Permanent memory. Local memory infrastructure. API-provider agnostic. Surgically token-efficient.\n\nSeven memory layers. Automatic, intelligent context injection. Structured facts with trust scoring. A self-curating wiki pipeline. Semantic search across **every conversation you've ever had**.\n\nMemory OS turns Hermes Agent into a real long-term collaborator — one that remembers your projects, your decisions, your reasoning, and brings exactly the right context back at exactly the right moment. Like talking to a colleague who was there for every session.\n\n**Memory infrastructure runs entirely on your machine. Works with any LLM provider — OpenRouter, OpenAI, Anthropic, Ollama, or local models. No memory subscription. No vendor lock-in.**\n\n---\n\n## What's New in v0.2.0\n\n**One-command install.** `curl -sSL https://raw.githubusercontent.com/ClaudioDrews/memory-os/main/setup.sh | bash` sets up the entire stack — Docker services, SQLite databases, Icarus plugin, environment — in one shot. The 10-step manual guide is now a fallback for troubleshooting.\n\n**Community infrastructure.** Issue templates (bug report + feature request), PR checklist, and contributing guide. Project is ready for external contributors — and already has them.\n\n**20+ fixes from systematic audit.** Community-driven review across setup, configuration, performance, and resilience. Highlights: provider-agnostic LLM extraction, O(1) path lookups, FTS5-powered session search, semantic dedup at scale, and idempotent database initialization.\n\n**Installation verified on real hardware.** Smoke tests and ingestion tests ship with the repo. The automated installer has been tested end-to-end — including on modest machines where Docker build times exposed UX gaps that are now handled gracefully.\n\n---\n\n## The problem every serious Hermes user knows\n\nYou spend hours configuring the agent, teaching it your preferences, solving hard problems together — and in the next session it acts like it's meeting you for the first time.\n\n- Repeating context at the start of every conversation\n- Losing the thread of important decisions made weeks ago\n- Structured facts — your stack, your projects, your patterns — with nowhere to live\n- Every memory solution you've tried is either cloud-locked or too shallow to matter\n\nAfter months of hitting these walls in production, I built something that actually works.\n\n---\n\n## What Memory OS is\n\nNot just another plugin. A complete **memory operating system** — 7 layers working in concert, from flat files to a vector database, with surgical context injection, a knowledge pipeline that organizes itself, **and an explicit Ground Truth hierarchy that tells the agent to actually use the injected memory**.\n\nDesigned and refined by someone who ran headfirst into every limitation of stock Hermes and every existing memory solution.\n\n**Requirements:** Hermes Agent + Docker (Qdrant + Redis + ARQ Worker) + Python 3.11+.  \nCompatible with any LLM provider Hermes supports — OpenRouter, OpenAI, Anthropic, Ollama, and more.\n\n---\n\n## Architecture: 7 memory layers\n\n```\n┌──────────────────────────────────────────────────────────────────┐\n│  LAYER 1 · WORKSPACE                                              │\n│  MEMORY.md · USER.md · CREATIVE.md                               │\n│  → Injected into the system prompt every single turn             │\n├──────────────────────────────────────────────────────────────────┤\n│  LAYER 2 · SESSIONS                                               │\n│  state.db (SQLite + FTS5)                                         │\n│  → Full-text search across your entire conversation history       │\n├──────────────────────────────────────────────────────────────────┤\n│  LAYER 3 · STRUCTURED FACTS                                       │\n│  memory_store.db (SQLite + HRR + FTS5 + trust scoring)            │\n│  → Durable facts with entity resolution and an automat","github_created_at":"2026-05-31T19:50:25+00:00","created_at":"2026-07-07T17:44:40.660794+00:00","updated_at":"2026-08-21T18:01:53.417187+00:00","categories":[{"slug":"ai-agents","name":"AI Agents","url":"https://www.graphcanon.com/categories/ai-agents","markdown_url":"https://www.graphcanon.com/categories/ai-agents.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/ai-agents"},{"slug":"vector-databases","name":"Vector Databases","url":"https://www.graphcanon.com/categories/vector-databases","markdown_url":"https://www.graphcanon.com/categories/vector-databases.md","api_url":"https://www.graphcanon.com/api/graphcanon/categories/vector-databases"}],"tags":[{"slug":"ai-memory","name":"ai-memory"},{"slug":"context-injection","name":"context-injection"},{"slug":"docker","name":"docker"},{"slug":"ground-truth","name":"ground-truth"},{"slug":"hermes-agent","name":"hermes-agent"},{"slug":"local-first","name":"local-first"},{"slug":"open-source","name":"open-source"},{"slug":"persistent-memory","name":"persistent-memory"}],"trust":{"provenance":{"is_fork":false,"github_id":1255412388,"owner_type":"User","methodology":"github_public_v1","parent_repo":null,"near_duplicate_slugs":[]},"computed_at":"2026-08-21T18:01:52.616Z","maintenance":{"label":"Steady","score":60,"methodology":"github_public_v1","releases_90d":0,"days_since_push":72,"last_release_at":null,"stars_delta_30d":41,"open_issues_delta_30d":2},"security_summary":{"status":"no_lockfile","scanner":null,"low_count":0,"high_count":0,"last_scan_at":"2026-07-11T11:26:24.237Z","medium_count":0,"scan_profile":"none","critical_count":0}},"capability_facts":{"scan":{"source":"repo_scan","observed_at":"2026-08-21T18:01:53.080Z"},"languages":{"value":["python"],"source":"github.language","observed_at":"2026-08-21T18:01:53.080Z"},"license_spdx":{"value":"MIT","source":"github.license","observed_at":"2026-08-21T18:01:53.080Z"}},"decision_facts":{"hosting":null,"pricing":null,"requirements":null,"constraints":null,"when_to_use":["- You are working with Hermes Agent and require a sophisticated memory management solution that operates locally.","- Your project involves the need for surgical context injection into the AI processes to enhance precise fact recall.","- You prioritize self-hosted solutions over cloud-based services and prefer an open-source, MIT-licensed package."],"when_not_to_use":["- If you are looking for a completely cloud-managed service without any local setup or maintenance needs.","- Your use case does not align with Hermes Agent; Memory-OS is specifically designed to complement this agent's functions and won't provide the same benefits when used independently."],"source":"enrich:decision_facts","observed_at":"2026-07-12T03:26:36.818Z"},"constraint_facets":null,"decision_summary":[{"label":"Adopt for","value":"Memory-OS is a memory operating system tailored for Hermes Agent, focusing on local-first, self-hosted persistent storage and seamless integration with any LLM provider using Qdrant as the vector database."}]}}