Hebbrix
SDKs

SDKs & Libraries

Official client libraries for Python and TypeScript with type safety, auto-retries, and async support.

Python SDK

Python 3.8+

Install
pip install hebbrix

Features

Type Safety

Full TypeScript types and Python type hints

Auto Retries

Exponential backoff for transient errors

Async Support

Native async/await for non-blocking ops

Quick Start

Python
from hebbrix import Hebbrix

# Initialize (uses HEBBRIX_API_KEY env var)
client = Hebbrix()

# Create a memory
memory = client.memories.create(
    content="User prefers dark mode",
    tags=["preferences"]
)

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

# Chat with memory
response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "What do I prefer?"}]
)

Installation Options

All Package Managers
# Using pip
pip install hebbrix

# Using poetry
poetry add hebbrix

# Using pipenv
pipenv install hebbrix

Async Usage

Python
import asyncio
from hebbrix import AsyncHebbrix

async def main():
    client = AsyncHebbrix()

    # Async operations
    memory = await client.memories.create(content="Test")
    results = await client.search("query")

    # Parallel requests
    data = await asyncio.gather(
        client.memories.get("mem_abc"),
        client.search("preferences")
    )

asyncio.run(main())

Error Handling

Python
from hebbrix import Hebbrix
from hebbrix.exceptions import (
    HebbrixError, AuthenticationError,
    RateLimitError, ValidationError
)

client = Hebbrix()

try:
    memory = client.memories.create(content="Test")
except AuthenticationError:
    print("Invalid API key")
except RateLimitError as e:
    print(f"Retry after {e.retry_after}s")
except HebbrixError as e:
    print(f"Error: {e.status_code}")

Configuration

Python
from hebbrix import Hebbrix

client = Hebbrix(
    api_key="mem_sk_...",
    base_url="https://api.your-domain.com",
    timeout=30.0,
    max_retries=3
)

OpenAI Compatibility

Use Hebbrix as a drop-in replacement for OpenAI SDK:

Python (OpenAI SDK)
from openai import OpenAI

# Drop-in replacement for OpenAI
client = OpenAI(
    api_key="mem_sk_your_hebbrix_key",
    base_url="https://api.hebbrix.com/v1"
)

response = client.chat.completions.create(
    model="gpt-4",
    messages=[{"role": "user", "content": "Hello!"}]
)
# Automatic memory injection!

Available Methods

ResourceMethods
client.memoriescreate, get, list, update, delete, batch_create
client.searchquery, similar, advanced, graph
client.chat.completionscreate, createStream
client.collectionscreate, get, list, update, delete
client.documentsupload, get, list, delete, chunks
client.profileget, update, dialectic, delete
client.graphentities, relationships, query
client.webhookscreate, get, list, update, delete, test
client.usageget, history

Next Steps

Assistant

Ask me anything about Hebbrix