The UI renders, but the counters read 0 and the list is empty.

• Confirm ~/.mempalace/palace/chroma.sqlite3 exists. If it doesn't, MemPalace itself hasn't been initialised on this machine — file at least one memory through MemPalace first.
• If your palace lives elsewhere, set MEMPALACE_PALACE_DB and MEMPALACE_KG_DB to the correct absolute paths and restart.
• Check the server log — Apricity prints the exact paths it tried to open.

Reads work, but every write fails with a subprocess error mentioning ModuleNotFoundError: No module named 'mempalace'.

• MEMPALACE_PYTHON_BIN points at a Python that can't import mempalace. Test it:

  $MEMPALACE_PYTHON_BIN -c "import mempalace; print(mempalace.__file__)"

• Fix the path, or install mempalace into that venv, then restart Apricity.

rm ~/.mempalace/dashboard-credentials.json ~/.mempalace/dashboard-sessions.json

Restart and re-enroll via Settings → Account. This does not touch your memories.

PORT=9000 python3 server.py

That's the optimistic-save safety net: the UI applied your edit instantly, the server rejected it (often an ETag conflict — the memory changed underneath you), so it rolled back. Reopen the memory to get the current version, then re-apply your edit. Use the retry affordance if offered.

Browsers block audio until you interact with the page. Click or press a key once to unlock it, then use Settings → Notifications → Test notification. Also check that Mute notification sound and Suppress notifications are off.

Apricity minifies JavaScript at serve time. To rule the minifier out while debugging, set MEMPALACE_NO_MINIFY=1 and restart.

Is this an official MemPalace project? No. Apricity is a community front-end that talks to the official mempalace package. MemPalace itself lives at MemPalace/mempalace.

Does it work offline? Yes. The server is loopback-only and the front-end is vendored — no CDNs, no analytics. The only outbound call is an optional, cached check of the GitHub releases API to tell you when a new Apricity version exists.

Do my memories leave my machine? Never. Apricity reads and writes only files under $MEMPALACE_HOME. There's no network code in the data path.

Can I run more than one instance? Yes — give each its own PORT, and (for isolated palaces) its own MEMPALACE_HOME.

Why no required pip install? The whole server is one file of standard-library Python. Keeping it dependency-free means you can audit it, vendor it, or run it on a fresh box without worrying about supply chains. The pip/pipx package exists only so installing it is one command.

Does it keep a full edit history? No — by design. The versions log is for recovering deletions. Edits are protected from accidental overwrite by ETag concurrency but aren't snapshotted as a running history.

Can I reach it from my phone / another computer? It binds to 127.0.0.1 deliberately. Put a reverse proxy or Tailscale in front of it — never expose the raw port. See Security & Safety.

Still stuck? Open an issue on the repo.