Dobby SDK
Dobby ships two SDK families in both Python and JavaScript/TypeScript. Pick by job:
"I want to call Dobby"
Chat completions, task management, approvals, agent fleet, key management — all wrapped as typed resources.
"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
Python
dobby-ai-sdkOfficial Python SDK with sync & async support. Wraps OpenAI SDK for LLM calls.
pip install dobby-ai-sdkJavaScript / TypeScript
@dobbyai/sdkTypeScript-native SDK with full type safety. Works in Node.js 18+.
npm install @dobbyai/sdkQuick 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 Tier | Prefix | Use Case | Rate Limit |
|---|---|---|---|
| User | gk_user_* | IDE users | 100 RPM |
| Service | gk_svc_* | Agents, CI/CD | 500 RPM |
| Temporary | gk_tmp_* | Short-lived | 30 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.
Python Collector
dobby-collectorInstrument LangChain / CrewAI / AutoGen / OpenAI Assistants agents. v0.4.4 LIVE on PyPI.
pip install dobby-collectorNode Collector
@dobbyai/collectorInstrument LangChain.js / Mastra / Vercel AI SDK / custom agents. v0.1.0 LIVE on npm.
npm install @dobbyai/collector