Web UI

Postgram ships with a web UI focused on graph-first exploration, search, and quick entity editing.

What this page covers

What the UI provides, how to run it, and how it connects to your Postgram API.

Core workflow

1. The UI runs as its own container and proxies /api/* to Postgram:

• Browser → http://127.0.0.1:3000 by default
• postgram-ui /api/* → mcp-server:3100/api/*

2. Use local login flow:

• Enter an API key once.
• The key is stored in browser local storage and sent as Authorization: Bearer.

3. Use the canvas to:

• search and jump to entities
• filter by entity type and relation type
• filter memory rows by durable_memory or session_context
• adjust depth and queue status
• open entity details and linked neighbors

4. Modify entities from the right panel:

• edit metadata and tags
• add memory notes linked to selected entity
• create links with relation types
• delete when needed

5. Create a focused view:

• start a query, set filters, and expand neighborhoods with depth 1–3.

Notes

• If you are embedding the UI in another host network, point its API proxy to your Postgram host and ensure container networking is consistent.
• The UI is implemented as a React/Vite SPA and can be added via a dedicated ui/ service in Compose.
• Treat the browser profile as trusted: clear local storage when using a shared computer, and do not use a browser API key as an Admin credential.