Skip to main content
The Kubiya Python SDK provides comprehensive programmatic access to the Kubiya platform, enabling you to build, deploy, and manage AI-powered automation workflows with Python.

​
Core Capabilities

Client SDK

Manage agents, execute workflows, configure integrations, and handle secrets via Python APIs

Control Plane Client

Access control plane services including context graph, models, runtimes, and skills

Workflow DSL

Define workflows as Python code with type safety and IDE support

Real-time Streaming

Stream workflow execution events for monitoring and responsive UIs

Production Ready

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

​
Quick Example

from kubiya import KubiyaClient, ControlPlaneClient, workflow

# Initialize platform client
client = KubiyaClient(api_key="your-api-key")

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

# Query context graph
nodes = cp_client.graph.list_nodes(integration="aws", limit=10)
print(f"Found {len(nodes['nodes'])} entities")

# Define a workflow using the DSL
wf = (
    workflow("deploy-service")
        .description("Deploy application to Kubernetes")
        .step("build", "docker build -t myapp:latest .")
        .step("push", "docker push myapp:latest")
        .step("deploy", "kubectl apply -f deployment.yaml")
        .step("verify", "kubectl rollout status deployment/myapp")
)

# Execute with streaming
for event in client.execute_workflow(wf.to_dict(), stream=True):
    print(f"Status: {event}")

​
SDK Components

​
Client SDK

The Client SDK provides Python interfaces to all Kubiya platform services:
  • Agents Service: Create and manage AI agents
  • Workflows Service: Execute and monitor workflows
  • Integrations Service: Connect external services
  • Secrets Service: Secure credential management
  • Knowledge Service: Query the knowledge base
Learn more about the Client SDK →

​
Control Plane Client

The Control Plane Client provides access to orchestration and infrastructure services:
  • Context Graph: Query entities and relationships from any data source
  • Models Service: Manage LLM models (Claude, GPT-4, Gemini, etc.)
  • Runtimes Service: Agent runtime configurations
  • Skills Service: Tool sets and capabilities
  • Health Service: Monitor system health and dependencies
Learn more about the Control Plane Client →

​
Workflow DSL

The Workflow DSL lets you define complex automation workflows using Python:
  • Steps: Atomic operations with dependencies
  • Conditions: Branching logic and control flow
  • Error Handling: Retry policies and fallback strategies
  • Testing: Unit and integration testing support
Learn more about the Workflow DSL →

​
What You Can Build

  • CI/CD Pipelines - Automated build, test, and deployment workflows
  • Infrastructure Automation - Terraform, Kubernetes, and cloud operations
  • Data Pipelines - ETL workflows and data processing automation
  • Incident Response - Automated runbooks and remediation workflows
  • AI Agents - Custom agents with tools and integrations

​
Getting Started

1

Install the SDK

pip install kubiya-sdk
2

Configure Authentication

export KUBIYA_API_KEY="your-api-key"
3

Write Your First Workflow

from kubiya import workflow

wf = workflow("hello-world").step("greet", "echo 'Hello from Kubiya!'")
4

Execute

from kubiya import KubiyaClient

client = KubiyaClient()
for event in client.execute_workflow(wf.to_dict(), stream=True):
    print(event)
View detailed installation guide →

​
Architecture

​
Next Steps

Installation & Setup

Get the SDK installed and configured in minutes

Quick Start Guide

Build your first workflow in under 5 minutes

Client SDK Reference

Explore all platform services and APIs

Control Plane Client

Access orchestration and graph services

Context Graph

Query entities and relationships

Workflow DSL Guide

Master the workflow definition language

Examples Gallery

Browse real-world usage patterns

API Reference

Complete API documentation

​
Support & Community