Quickstart

pip install hx-sdk

export HX_API_KEY="your-api-key"

from hx import Client

client = Client()

# Verify your context
print(f"Org: {client.org_id}")
print(f"Workspace: {client.workspace_id}")
print(f"Environment: {client.environment_id}")

results = client.knowledge.search(
    store_id="ks-your-store-id",
    query="How do I reset my password?",
    top_k=5
)

for result in results["results"]:
    print(f"Score: {result['score']}")
    print(f"Text: {result['text'][:200]}...")

# Store a memory
client.memory.add(
    store_id="ms-your-store-id",
    user_id="user_123",
    messages=[
        {"role": "user", "content": "My name is Alex."}
    ],
    metadata={"type": "identity"}
)

# Search memories
memories = client.memory.search(
    store_id="ms-your-store-id",
    query="What is my name?",
    user_id="user_123",
    top_k=10
)

print(memories["results"])