GoldHold Python SDK

Your AI agent forgets everything when the session ends. GoldHold fixes that.

Persistent memory that survives session boundaries, compaction, and crashes. 14 memory types, 4 storage classes, semantic search, cross-agent messaging -- all through a simple Python client.

pip install goldhold

Why GoldHold?

• Survives death -- agent context is preserved across sessions, restarts, and compaction events
• Semantic search -- find relevant memories by meaning, not keywords
• Cross-agent messaging -- agents on the same account can communicate via GUMP protocol
• Zero LLM overhead -- retrieval uses 9-factor scoring (temporal decay, evidence, associations), no extra model calls
• Compound operations -- search + store + send in a single API call (saves tokens and latency)
• Works with any framework -- OpenClaw, LangChain, CrewAI, AutoGen, raw Python scripts

Quickstart

from goldhold import GoldHold

gh = GoldHold(api_key="your-key")

# Store a memory
gh.store("User prefers dark mode", "Stated explicitly on March 9", type="FACT")

# Search memories
results = gh.search("user preferences")

# Compound turn -- search + store in one call
resp = gh.turn(
    search={"query": "project status"},
    store={"subject": "Deploy complete", "body": "v2 shipped", "type": "DECISION"},
)

# Session resume
auto = gh.auto(context_budget=2000)

# Check status
status = gh.status()
print(f"{status.namespace}: {status.total_vectors} vectors")

Setup

GoldHold.setup()  # interactive -- prints signup URL, saves key to ~/.goldhold/config.json

Or set GOLDHOLD_API_KEY in your environment.

API

Tiers

Sign up at goldhold.ai/account.

Error Handling

from goldhold.exceptions import AuthError, RateLimitError, VectorLimitError

try:
    gh.store("test", "test")
except VectorLimitError:
    print("Upgrade to Vault Pro for unlimited vectors")
except AuthError:
    print("Bad API key")
except RateLimitError:
    print("Slow down")

Patent Pending. All Auto Tunes LLC. U.S. Patent Application #63/988,484.