Zaby SDK

The official SDK for the Zaby AI Agent Platform. Use Python or TypeScript to create agents, manage deployments, stream runtime responses, and integrate with external tools.

Select your preferred language tab for code examples: Python or TypeScript.

Quick Start

Install, authenticate, and run your first agent in under 5 minutes.

Configuration

Timeouts, retries, dynamic auth providers, and environment setup.

Client Reference

Full API reference for all clients — agents, runtime, MCP, memory, and more.

Error Handling

Error types, status codes, retry strategies, and best practices.

Minimal Example

Python
TypeScript

import asyncio
from zaby import Zaby

async def main():
    zaby = Zaby(api_key="zaby_pk_...")

    agent = await zaby.agents.create({
        "name": "my-agent",
        "slug": "my-agent",
    })
    print(f"Agent created: {agent['id']}")

    health = await zaby.health.check()
    print(f"Server status: {health['status']}")

asyncio.run(main())

import { Zaby } from "@zaby-ai/sdk";

async function main() {
  const zaby = new Zaby({
    apiKey: "zaby_pk_...",
  });

  const agent = await zaby.agents.create({
    name: "my-agent",
    slug: "my-agent",
  });
  console.log(`Agent created: ${agent.id}`);

  const health = await zaby.health.check();
  console.log(`Server status: ${health.status}`);
}

main();

Two Client Modes

The SDK provides two client classes for different contexts:

Zaby

Admin-level operations: create agents, manage deployments, configure MCP servers, create runtime tokens.

Auth: API key (x-zaby-api-key) + optional JWT

ZabyRuntime

Runtime agent interactions: start runs, stream SSE events, submit feedback and approvals.

Auth: Runtime token JWT (authorization: Bearer)

Getting Started

Clients

Guides

Zaby SDK

Zaby SDK

Quick Start

Configuration

Client Reference

Error Handling

Installation

Minimal Example

Two Client Modes

Zaby

ZabyRuntime

What’s Next?

​Zaby SDK

Quick Start

Configuration

Client Reference

Error Handling

​Installation

​Minimal Example

​Two Client Modes

Zaby

ZabyRuntime

​What’s Next?

Zaby SDK

Installation

Minimal Example

Two Client Modes

What’s Next?