SDKs
SDKs & Libraries
Official client libraries for Python and TypeScript with type safety, auto-retries, and async support.
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 hebbrixAsync 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
| Resource | Methods |
|---|---|
| client.memories | create, get, list, update, delete, batch_create |
| client.search | query, similar, advanced, graph |
| client.chat.completions | create, createStream |
| client.collections | create, get, list, update, delete |
| client.documents | upload, get, list, delete, chunks |
| client.profile | get, update, dialectic, delete |
| client.graph | entities, relationships, query |
| client.webhooks | create, get, list, update, delete, test |
| client.usage | get, history |
