qubac 1.2.0

Qubac SDK — Python client for SAM, the governed agentic AI runtime

Qubac SDK

Python client for SAM — the governed agentic AI runtime.

Installation

pip install qubac

Quick start

from qubac import SAM

sam = SAM(api_key="sk-...")
task = sam.tasks.run("What is the capital of Pakistan?")
print(task.output)  # "The capital of Pakistan is Islamabad."

Multi-user applications

# Client configured once with tools and persona
sam = SAM(
    api_key="sk-...",
    system_prompt="You are a customer support agent for Acme Corp.",
    tools="./tools/",   # auto-discovered Python functions
)

# Per-user tasks
task = sam.tasks.run("Check order #1234", end_user_id=user.id)

# User-scoped client — recommended for multiple operations per user
user_sam = sam.with_user(user.id)
task = user_sam.tasks.run("Process refund for order #1234")
code = user_sam.agents.connect_code(label="Alice's MacBook")

Async

from qubac import AsyncSAM

async with AsyncSAM(api_key="sk-...") as sam:
    task = await sam.tasks.run("Analyse Q3 pipeline", end_user_id=user.id)
    print(task.output)

Error handling

from qubac import QubacRateLimitError, QubacAuthError, QubacServerError

try:
    task = sam.tasks.run("...")
except QubacRateLimitError as e:
    time.sleep(e.retry_after or 60)
except QubacAuthError:
    # Key revoked — check console.qubac.com
    ...
except QubacServerError as e:
    logger.error("SAM error", request_id=e.request_id)
    raise

Documentation

docs.qubac.com/sdk/python