Ailurus Memory

A shared, encrypted memory for your AI agents (Claude Code, LM Studio, anything that speaks MCP), self-hosted, with an admin web to see and edit what they remember. (Ailurus is the red panda's genus; the command is ai-memory.)

• One encrypted file. Records, history, agents and keys live in one SQLite file that is ciphertext on disk. The key comes from your passphrase and exists only in RAM.

• Per-agent keys and permissions per namespace (none / read / read-write), revocable.

• History and revert, duplicate warnings, verification stamps, semantic search that understands Czech as well as English, attachments.

• One port: the admin web at /, MCP at /mcp. Who may connect (IP ranges, host names, trusted proxy) and HTTPS (self-signed or your own certificate) are set in the admin web.

• Backups are just copies of that file, safe to put anywhere: without the passphrase they are unreadable.

Quick start

Docker (amd64 and arm64, HTTPS with a self-signed certificate out of the box):

curl -O https://raw.githubusercontent.com/TursiThePanda/ailurus-memory/master/docker-compose.yml
docker compose up -d && docker attach ailurus-memory     # first start: type a new passphrase twice, then Ctrl-P Ctrl-Q
docker exec -it ailurus-memory ai-memory-manage add-agent claude   # prints the agent key

Details: docs/install/docker.md.

Windows: download ailurus-memory-<version>-windows-setup.exe (or the portable zip) from Releases and run it (step by step). SmartScreen may warn about an unsigned program: More info → Run anyway.

Linux: the portable tarball from Releases, or from source with ./packaging/install.sh (systemd unit and tray indicator) — see the guide.

Related MCP server: Agent Memory

Connect an agent

claude mcp add ai-memory --transport http https://<your-host>:8080/mcp \
  --header "Authorization: Bearer <agent-key>"

Then open https://<your-host>:8080/ and sign in with the passphrase to manage agents, browse and edit memories, and set network access and HTTPS.

Documentation

Licence

© 2026 David Urban. PolyForm Noncommercial 1.0.0: free to use, study and change for personal, hobby, educational and other non-commercial purposes. Commercial use — by or for a company, or reselling it — needs my written permission; ask in Issues.