Zaby Python SDK

External agent + runtime SDK for Zaby (zaby-sdk).

This package is not a full backend or dashboard client. It wraps managed-agent / Agentic OS APIs so your app can configure agents, mint disposable runtime tokens, and run/stream agents.

Scope

In scope

• Managed agents (API-key provisioning + optional tenant JWT agent routes)
• Deployments, external apps, disposable runtime tokens
• Runtime runs + AG-UI SSE streaming
• Knowledge bases, MCP, memory, intelligence, approvals, usage (agent-facing)

Out of scope

• Admin / Customer apps
• Tenant modules: billing, users, roles, org, branding, WhatsApp, meetings, support, FAQs
• GPA chat, BIA, workflows, app-studio, file library
• API-key CRUD, credential vault, public marketing APIs

Use the Zaby dashboard or internal platform clients for those.

Install

pip install zaby-sdk

Configure

fromzabyimportconfigure_zaby, ZabyGlobalConfigconfigure_zaby(ZabyGlobalConfig(environment="production"))

Provisioning client (Zaby)

fromzabyimportZabyasyncwithZaby(api_key="zaby_pk_...") aszaby:
app=awaitzaby.external_apps.create({
"name": "Acme Web",
"slug": "acme-web",
"allowedOrigins": ["https://app.acme.com"],
})

Prefer agents / external_apps / runtime_tokens.
tenant_agents is only managed-agent JWT routes — not the full tenant API.

Runtime client (ZabyRuntime)

fromzabyimportZabyRuntimeasyncwithZabyRuntime(token="disposable_token") asruntime:
run=awaitruntime.runs.start({"input": "Hello"})
asyncforeventinruntime.runs.stream(str(run["runId"])):
print(event)

Development

pip install -e ".[test]"
pytest