Skip to main content
The Kubiya Python SDK provides programmatic access to the Kubiya Control Plane, enabling teams to manage organization-scoped resources such as Agents, Models, Skills, and the global Context Graph.

​
Requirements

  • Python 3.8 or higher
  • pip or poetry package manager
  • A Kubiya API key from the Kubiya platform
For installation instructions, see the Installation Guide.

​
Core Capabilities

Control Plane Client

Manage organization-scoped resources (Agents, Context Graph, Models, Skills)

Context Graph

Query entities and relationships with intelligent search

Real-time Streaming

Stream long-running operations and events from Control Plane endpoints

Production Ready

Error handling, retries, logging, and async support built-in

​
Quick Example

from kubiya import ControlPlaneClient

# Initialize control plane client
cp = ControlPlaneClient(api_key="your-api-key")

# List organization resources
agents = cp.agents.list()

print(f"Agents: {len(agents)}")

​
SDK Components

​
Control Plane Client

The Control Plane Client provides access to organization-scoped services:
  • Agents: manage agent records and executions at the organization level
  • Task Planning: AI-powered task decomposition and planning
  • Context: resolve entity context with inheritance across organizational layers
  • Context Graph: query and resolve entity relationships
  • Models, Runtimes, Skills, Policies: configure LLMs, runtimes, tools, and access controls
  • Workers, Secrets, Integrations: manage infrastructure, credentials, and external integrations
Learn more about the Control Plane Client →

​
What You Can Build

  • Organization automation — Manage agents and their executions across your enterprise
  • Context-aware applications — Use the Context Graph to resolve entity relationships and make informed decisions
  • AI-powered task planning — Decompose complex tasks into executable steps

​
Getting Started

1

Install the SDK

pip install kubiya-sdk
2

Use the Control Plane client

from kubiya import ControlPlaneClient

cp = ControlPlaneClient(api_key="your-api-key")
print(cp.agents.list())
View detailed installation guide →

​
Architecture

​
Next Steps

Installation & Setup

Get the SDK installed and configured in minutes

Control Plane Client

Access orchestration and graph services

Context Graph

Query entities and relationships

Examples Gallery

Browse real-world usage patterns

API Reference

Complete API documentation

​
Support & Community