Graph Viewer

SmartMemory stores your memories as a knowledge graph. This page shows how to look at that graph in each mode.

Lite: the built-in viewer

In Lite mode the local SmartMemory daemon serves a graph viewer. Open it with:

sm viewer

The 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:Qxxx node connected by a GROUNDED_IN edge.
• Edges: relations such as RELATED_TO, MENTIONS, GROUNDED_IN, PART_OF, SUPERSEDES, and DERIVED_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