# personal-memory

> Wizard, Docker Compose, and a shared indexer for Hindsight, mem0, or Cognee. Provider badges on this site come from manifests at build time.

Source: https://github.com/bcmyguest/personal-memory

## Docs

- [Quickstart](https://bcmyguest.github.io/personal-memory/docs/getting-started.md): Run the wizard once (npx or git checkout), verify health, optional MCP install.
- [Installing with npx](https://bcmyguest.github.io/personal-memory/docs/npx-install.md): Install and run the personal-memory wizard through npx.
- [Architecture](https://bcmyguest.github.io/personal-memory/docs/architecture.md): Runtime data flow, how changes update memory, and MCP access per provider.
- [Provider status](https://bcmyguest.github.io/personal-memory/docs/provider-status.md): Every provider, its status, and its self-host story, generated from the provider manifests.
- [Hindsight](https://bcmyguest.github.io/personal-memory/docs/hindsight.md): Default Compose stack, LiteLLM, loopback API, session hooks, and optional plugin.
- [Model configuration](https://bcmyguest.github.io/personal-memory/docs/model-configuration.md): LiteLLM aliases and backends for Hindsight retain, reflect, and consolidate.
- [mem0](https://bcmyguest.github.io/personal-memory/docs/mem0.md): Self-hosted mem0 REST URL, API key file, and Cursor MCP install.
- [Cognee](https://bcmyguest.github.io/personal-memory/docs/cognee.md): Loopback Cognee container, REST ingest, and read-only MCP tools.
- [Memory portability](https://bcmyguest.github.io/personal-memory/docs/memory-portability.md): PMM export/import format and unified MCP memory_export / memory_import behavior.
- [Configuration file](https://bcmyguest.github.io/personal-memory/docs/personal-memory-config.md): The mise-like config.toml: files, precedence, sections, and the pm tasks.
- [Index sources](https://bcmyguest.github.io/personal-memory/docs/index-sources.md): Git, Obsidian, notes, papers, bookmarks, and feed cache banks for the shared indexer.
- [Feed sync](https://bcmyguest.github.io/personal-memory/docs/sources-feeds.md): RSS and OpenAlex queries into a watched markdown cache for feed::* banks.
- [Zotero exports](https://bcmyguest.github.io/personal-memory/docs/sources-zotero.md): Point papers.paths at Zotero markdown export folders.
- [Readwise exports](https://bcmyguest.github.io/personal-memory/docs/sources-readwise.md): Readwise markdown export directories as notes or papers sources.

## Providers

Generated from providers/*/manifest.json at build time.

- Cognee (cognee): Supported. Docker Compose services: cognee, indexer. Default host port 8766 (COGNEE_PORT).
- Hindsight (hindsight): Supported. Docker Compose services: litellm, hindsight, indexer. Default host port 8888 (HINDSIGHT_PORT).
- mem0 (mem0): Supported. Docker Compose services: indexer. Default host port 18888 (MEM0_PORT).
- Graphiti (graphiti): Planned. Not wired yet: no compose services declared.
- Letta (letta): Planned. Not wired yet: no compose services declared.
- Zep (zep): Planned. Not wired yet: no compose services declared.

## Works today

- Interactive and non-interactive wizard: configure, start, stop, --yes, --dry-run
- Provider manifests drive this site: supported today: Cognee, Hindsight, mem0
- Hindsight stack through Docker Compose, with a LiteLLM proxy in front of lemond, Ollama, or a custom endpoint
- mem0 (URL-only) and Cognee (pinned Docker image) compose profiles with provider wizard hooks and indexer sinks
- Indexer for git repositories and Obsidian vaults, with tree-sitter outlines and secret-path masking
- Smoke retain and recall, and an idempotent rerun that reports changed=N
- Declarative config.toml and npx personal-memory tasks: up, down, doctor, install-mcp, switch
- Unified personal-memory MCP (memory_add/search/recall/forget, PMM export/import) via install-mcp
- Opt-in NotebookLM sync; install-mcp also registers the NotebookLM MCP when enabled
- Provider-native MCP (mem0/Cognee) still available with install-mcp --provider-only

## Up next

- PMM import: mem0 duplicate detection; richer Cognee export (full document text)
- Graphiti: manifest status is planned
- Letta: manifest status is planned
- Zep: manifest status is planned
- Live end-to-end runs against real mem0 and Cognee servers (required before supported)
- Further npm releases

## Optional

- [Full docs in one file](https://bcmyguest.github.io/personal-memory/llms-full.txt)