Dobby

Dobby SDK

Dobby ships two SDK families in both Python and JavaScript/TypeScript. Pick by job:

Client SDK (this page)

"I want to call Dobby"

Chat completions, task management, approvals, agent fleet, key management — all wrapped as typed resources.

Collector SDK (jump ↓)

"I want Dobby to see what my agent is doing"

Native Agent Telemetry — instrument your own agent code, stream events to Dobby for governance + compliance.

Client SDK — pick your language

Quick Start

from dobby_sdk import DobbyClient

client = DobbyClient(api_key="gk_user_...")

# Make an LLM call through Dobby Gateway
response = client.chat.completions.create(
    model="claude-sonnet-4-20250514",
    messages=[{"role": "user", "content": "Hello from Dobby!"}],
)
print(response.choices[0].message.content)

# Create a task
task = client.tasks.create(title="Review PR #42", priority="high")

# Check costs
costs = client.costs.summary(period="30d")

SDK Capabilities

OpenAI Compatible

Use standard OpenAI SDK patterns — just point to Dobby Gateway

Task Management

Create, list, update tasks programmatically

Approvals (HITL)

List pending approvals, approve or reject from code

Agent Fleet

Register external agents, pause/resume, monitor health

Cost Tracking

Query FinOps data — per-agent, per-provider breakdowns

Key Management

Create, rotate, revoke gateway API keys

Authentication

All SDK calls are authenticated with a Dobby Gateway API key. You can pass it directly or set the DOBBY_API_KEY environment variable.

Key TierPrefixUse CaseRate Limit
Usergk_user_*IDE users100 RPM
Servicegk_svc_*Agents, CI/CD500 RPM
Temporarygk_tmp_*Short-lived30 RPM

Collector SDK — Native Agent Telemetry

Different package, different job. The Collector SDKs instrument YOUR agent code (LangChain / CrewAI / Mastra / Vercel AI SDK / custom OpenAI scripts) and stream runs / tool calls / LLM calls to Dobby for governance + compliance scans.

Don't confuse them — the Client SDK above is for calling Dobby APIs; the Collector SDK below is for streaming agent telemetry TO Dobby. Different packages, different problems.

Why this matters: without the Collector SDK, agents running in your own infra (your VM, your Lambda, your K8s pod) are invisible to Dobby's Policy Scanner. The Collector closes that gap — same compliance scans + audit trail + governance controls as Dobby's native Surrounding / Inline / Hybrid modes, but for agents you run yourself.
Dobby AI Platform - AI Agents That Execute Real Work With Full Control