Graph Viewer
SmartMemory stores your memories as a knowledge graph. This page shows how to look at that graph in each mode.
| Mode | How to see the graph |
|---|---|
| Lite (on your machine) | Built-in graph viewer, opened with sm viewer |
| Service (managed API) | Fetch nodes and edges from the API with GET /memory/graph/full |
Lite: the built-in viewer
In Lite mode the local SmartMemory daemon serves a graph viewer. Open it with:
sm viewerThe command starts the daemon if it isn't running and opens the viewer in your
browser at http://localhost:9014 (the default daemon port, set by
daemon_port in your SmartMemory config). Use sm viewer --port <port> to open
a different port. No account or API key is needed.
What you see
- Nodes: memory items (semantic, episodic, procedural, decision, opinion, observation, code, and more) and the entities extracted from them (concept, person, organization, location, technology, and more). Wikidata-grounded entities show as a separate
wikidata:Qxxxnode connected by aGROUNDED_INedge. - Edges: relations such as
RELATED_TO,MENTIONS,GROUNDED_IN,PART_OF,SUPERSEDES, andDERIVED_FROM, plus any custom relation labels promoted into the workspace ontology. - Color coding: memory types use warm colors (semantic, episodic, decision), and entity types use cool colors (concept, person, technology).
- Type filters: color-coded checkboxes for memory types and entity types.
- Search: search nodes by label (Cmd/Ctrl+K).
- Detail panel: click a node to see its content, metadata, confidence, and timestamps.
- Layouts: force-directed, hierarchical, circle, concentric, and grid.
- Export: save the current view as PNG or SVG.
- Ask panel: ask a question about your memories next to the graph.
Live updates
The viewer subscribes to the daemon's progress stream at
GET /memory/progress/stream, so new nodes and edges appear as memories are
ingested. See Progress Events for
the event contract.
Service: graph data from the API
In Service mode your graph lives in the managed SmartMemory Service. Read it
through the API at https://api.smartmemory.ai with your API key and active
workspace:
curl https://api.smartmemory.ai/memory/graph/full \
-H "Authorization: Bearer $SMARTMEMORY_API_KEY" \
-H "X-Workspace-Id: $WORKSPACE_ID"The response holds the workspace's nodes and edges, plus node_count and
edge_count. The Python client exposes
the same call as get_graph_full():
from smartmemory_client import SmartMemoryClient
client = SmartMemoryClient(
base_url="https://api.smartmemory.ai",
api_key="sm_live_...",
workspace_id="your-workspace-id",
)
graph = client.get_graph_full(limit=500)To watch ingestion live, subscribe to GET /memory/progress/stream on the same
API. The JavaScript SDK
wraps it as subscribeProgress.
Related
- Progress Events API: live-feed event contract
- Lite mode
- System Overview
Connect Google for your Workspace (admin steps)
Use your organization's own Google OAuth client so your team can connect Google data to SmartMemory without the unverified app warning.
Holding Decisions for Review
Make a replacement of a decision wait for a person. See what is waiting, approve, reject, restore a replaced decision, and retract one.