Conductor Python SDK

1.3.11 verified Fri May 01 auth: no python

Python SDK for the Conductor workflow orchestration platform. v1.3.11 supports Python >=3.9. Active development with bi-monthly releases.

pip install conductor-python

Common errors

error ModuleNotFoundError: No module named 'conductor' ↓

cause Old package name; `conductor-python` must be installed.

fix

pip install conductor-python

error AttributeError: 'OrchestrationClient' object has no attribute 'get_workflow' ↓

cause Method `get_workflow` is plural `get_workflows` in recent versions.

fix

Use client.get_workflows() (plural) method.

Warnings

breaking v1.0.0 migrated from `conductor` package to `conductor-python` PyPI name. Old `conductor` package is unrelated. ↓

fix Use `pip install conductor-python` and update imports to use `conductor.client`.

deprecated `TaskRunner` with positional `domain` argument is deprecated. Use keyword argument. ↓

fix `TaskRunner(worker, domain='test')` instead of `TaskRunner(worker, 'test')`.

gotcha Client authentication requires `key_id` and `key_secret` for Orkes, but may be omitted for local Conductor servers. If omitted for Orkes, API calls fail with 401. ↓

fix Always provide auth credentials when using Orkes. For local, set to empty string or use token auth if configured.

Imports

OrchestrationClient
```
from conductor.client import OrchestrationClient
```
Correct import path for the main client

TaskRunner

from conductor.task_runner import TaskRunner

Import for running worker tasks

Quickstart

Initialize a client and list workflows (replace credentials with env vars)

from conductor.client import OrchestrationClient

client = OrchestrationClient(
    server_api_url='https://play.orkes.io/api',
    key_id='YOUR_KEY',
    key_secret='YOUR_SECRET'
)
print(client.get_workflows('my_workflow'))