Skip to main content
You’ll need a Nebula API key before starting. Get one at zeroset.com

​
Prerequisites

  • A Nebula account at zeroset.com
  • An existing Nebula collection with some stored memories (see Quick Start to create one)
  • Python: Python 3.10+ with pip install nebula-sdk
  • JavaScript/TypeScript: Node.js 18+ with npm install @nebula-ai/sdk

​
Install

pip install nebula-sdk

​
Walkthrough

1

Initialize the client

from nebula import Nebula

client = Nebula(api_key="YOUR_API_KEY")
2

Export a snapshot from an existing collection

snapshot = client.snapshots.export(collection_id="YOUR_COLLECTION_ID").results
After export, the local snapshot is the canonical copy. Nebula does not retain a server-side copy.
3

Store memories against your snapshot

Use the same memories.create() method you already know — just pass snapshot instead of collection_id.
result = client.memories.create(
    snapshot=snapshot,
    raw_text="Had a meeting with Alice about the Q2 roadmap",
).results
snapshot = result.snapshot
4

Search memory

Same memories.search() method — pass snapshot instead of collection_ids.
Snapshot search returns a graph shape (entities + relationships), distinct from the MemoryResponse returned by collection search.

​
Next Steps