Installation

pip install kubiya-sdk

git clone https://github.com/kubiyabot/workflow_sdk.git
cd workflow_sdk
pip install -e .

# For async support
pip install kubiya-sdk[async]

# For development tools
pip install kubiya-sdk[dev]

# Install all extras
pip install kubiya-sdk[all]

export KUBIYA_API_KEY="your-api-key-here"
export KUBIYA_ORG="your-organization-id" 
export KUBIYA_BASE_URL="https://api.kubiya.ai"  # Optional, defaults to this

api_key: your-api-key-here
organization: your-organization-id
base_url: https://api.kubiya.ai
timeout: 30
retry_attempts: 3

from kubiya_sdk import Kubiya

# Initialize with explicit configuration
client = Kubiya(
    api_key="your-api-key",
    organization="your-org",
    base_url="https://api.kubiya.ai",
    timeout=60,
    retry_attempts=3
)

from kubiya_sdk import Kubiya

# Test connection
client = Kubiya()

try:
    # List workflows to test connection
    workflows = client.workflows.list()
    print(f"✅ Connected successfully! Found {len(workflows)} workflows.")
except Exception as e:
    print(f"❌ Connection failed: {e}")

import kubiya_sdk

print(f"Kubiya SDK version: {kubiya_sdk.__version__}")

from kubiya_sdk import Step, Workflow

# Test DSL functionality
step = Step("test-step").tool("echo").inputs(message="Hello Kubiya!")
workflow = Workflow([step])

print("✅ SDK components imported successfully!")

{
    "python.linting.enabled": true,
    "python.linting.pylintEnabled": true,
    "python.formatting.provider": "black",
    "python.intelliSense.extraPaths": ["./kubiya_sdk"]
}

git clone https://github.com/kubiyabot/workflow_sdk.git
cd workflow_sdk

python -m venv kubiya-env
source kubiya-env/bin/activate  # On Windows: kubiya-env\Scripts\activate

pip install -e ".[dev]"

# Run unit tests
pytest tests/unit/

# Run integration tests (requires API key)
pytest tests/integration/

# Run all tests with coverage
pytest --cov=kubiya_sdk tests/

FROM python:3.11-slim

# Install kubiya-sdk
RUN pip install kubiya-sdk

# Set environment variables
ENV KUBIYA_API_KEY=your-api-key
ENV KUBIYA_ORG=your-org

# Copy your workflow code
COPY workflows/ /app/workflows/
WORKDIR /app

CMD ["python", "workflows/main.py"]

version: '3.8'
services:
  kubiya-workflows:
    build: .
    environment:
      - KUBIYA_API_KEY=${KUBIYA_API_KEY}
      - KUBIYA_ORG=${KUBIYA_ORG}
    volumes:
      - ./workflows:/app/workflows

ImportError: No module named 'kubiya_sdk'

pip list | grep kubiya-sdk
pip install kubiya-sdk

AuthenticationError: Invalid API key

echo $KUBIYA_API_KEY
echo $KUBIYA_ORG

ConnectionTimeoutError: Request timed out

client = Kubiya(timeout=120)  # 2 minutes

SSLError: certificate verify failed

import ssl
ssl._create_default_https_context = ssl._create_unverified_context

import logging
logging.basicConfig(level=logging.DEBUG)

from kubiya_sdk import Kubiya
client = Kubiya(debug=True)