statebase 0.2.0

The Reliability Layer for Production AI Agents

StateBase Python SDK

The official Python client for StateBase - The Reliability Layer for Production AI Agents.

📦 Installation

pip install statebase

🚀 Quick Start

1. Initialize

from statebase import StateBase

sb = StateBase(api_key="sb_live_...")

2. Sessions (The Interaction Loop)

# Create a session
session = sb.sessions.create(
    agent_id="coding-assistant",
    user_id="user_123"
)

# ... inside your chat loop ...
user_input = "How do I fix this bug?"

# Get Context (RAG + State + History)
ctx = sb.sessions.get_context(session.id, query=user_input)

# Generate with LLM
# ... call openai ...
ai_response = "You should check the stack trace."

# Log the Turn
sb.sessions.add_turn(
    session_id=session.id,
    input=user_input,
    output=ai_response
)

3. Memory (Long-term Knowledge)

# Add a fact
sb.memory.add(
    user_id="user_123",
    content="User prefers TypeScript over JavaScript",
    tags=["preference", "coding"]
)

# Search
facts = sb.memory.search(
    user_id="user_123",
    query="coding preferences"
)

📚 Documentation

Full docs: docs.statebase.org