66 lines
2.9 KiB
Markdown
66 lines
2.9 KiB
Markdown
---
|
|
type: project
|
|
status: active
|
|
source: git.alwisp.com
|
|
repo: jason/mempalace
|
|
repo_url: https://git.alwisp.com/jason/mempalace
|
|
language: Python
|
|
branch: main
|
|
tags: [repo, jason]
|
|
updated: 2026-05-29
|
|
---
|
|
|
|
# mempalace
|
|
|
|
**Repository:** [jason/mempalace](https://git.alwisp.com/jason/mempalace) · branch `main` · Python
|
|
|
|
## Summary
|
|
|
|
Server-mode fork of MemPalace — shared Docker container on Unraid so Claude Code, Codex, and MCP clients can share one persistent AI memory palace over LAN
|
|
|
|
## Current status
|
|
|
|
Active. Synced from Gitea on 2026-05-29.
|
|
|
|
## Documentation overview
|
|
|
|
# MemPalace — server-mode fork
|
|
|
|
Local-first AI memory, deployed as a shared service across machines.
|
|
|
|
This is a personal fork of [MemPalace](https://github.com/MemPalace/mempalace) configured for **server-mode deployment**: MemPalace runs as a Docker container (typically on Unraid) and multiple AI tools — Claude Code, Codex, Antigravity, or any MCP-compatible client — connect to a single shared palace from any machine on the network. Auto-save hooks on each client push session transcripts to the server over HTTPS with bearer auth.
|
|
|
|
The upstream project remains local-first by design. This fork makes one deliberate trade: data crosses the LAN to a user-controlled server instead of staying on the originating machine. Privacy, verbatim storage, no-cloud, and no-telemetry properties are otherwise unchanged. See [CLAUDE.md](CLAUDE.md) for the architectural reasoning.
|
|
|
|
---
|
|
|
|
## What's in this fork
|
|
|
|
```
|
|
home LAN
|
|
┌───────────────────────────────────┐
|
|
│ Unraid (always on) │
|
|
│ ┌────────────────────────────┐ │
|
|
│ │ caddy :8443 (TLS + auth) │ │
|
|
│ │ ├─ /sse → mcp-proxy │ │
|
|
│ │ └─ /ingest → ingest API │ │
|
|
│ │ mempalace (single process) │ │
|
|
│ │ ├─ mcp-proxy :8765 │ │
|
|
│ │ └─ ingest :8766 │ │
|
|
│ └────────────────────────────┘ │
|
|
└───────────────────────────────────┘
|
|
│ │ │
|
|
┌────┴───┐ ┌────┴───┐ ┌────┴─────┐
|
|
│ Claude │ │ Codex │ │ Antigrav │
|
|
└────────┘ └────────┘ └──────────┘
|
|
```
|
|
|
|
* **One palace, many clients.** Search and write target the same ChromaDB index regardless of which machine you're on.
|
|
* **Single bearer token gates everything.** Caddy sidecar terminates TLS and enforces `Authorization: Bearer <token>` at the edge.
|
|
|
|
…(truncated — see repo)
|
|
|
|
## Notes
|
|
|
|
- Project file auto-created from repo documentation.
|