orchestrator-client

Python client for the DAMIT AIOps Orchestrator REST API and Socket.IO realtime events.

Install

pip install orchestrator-client

Requires Python >= 3.12.

Quick Start

from orchestrator_client import Orchestrator

client = Orchestrator(base_url="http://localhost:8080")

# Create a task
task = client.create_task(
    workflow_id="proactive",
    goal_prompt="Analyze system logs for errors",
    max_iterations=50,
)
print(f"Created: {task.task_id}")

# Poll status
status = client.get_task_status(task.task_id)
print(f"Status: {status.status}, iteration {status.iteration}/{status.max_iterations}")

# List tasks
tasks = client.list_tasks(workflow_id="proactive", limit=10)
for t in tasks.tasks:
    print(f"  {t.id}: {t.status}")

# Cancel
client.cancel_task(task.task_id)

client.close()

Environment Variables

Variable	Default	Description
`ORCHESTRATOR_URL`	`http://localhost:8080`	Base URL (supports subpath)
`ORCHESTRATOR_API_KEY`	—	Optional bearer token
`ORCHESTRATOR_TIMEOUT`	`30.0`	HTTP timeout (seconds)
`ORCHESTRATOR_MAX_RETRIES`	`3`	Max retry attempts

SSL / Self-Signed Certificates

For orchestrator instances behind HTTPS with self-signed certificates, pass verify_ssl=False:

from orchestrator_client import Orchestrator

client = Orchestrator(
    base_url="https://orchestrator.internal:8443",
    verify_ssl=False,
)

Or inject a pre-configured httpx.AsyncClient for full control:

import httpx
from orchestrator_client import OrchestratorAsync

custom = httpx.AsyncClient(verify=False, timeout=httpx.Timeout(60.0))
client = OrchestratorAsync(http_client=custom)

## Async Variant

For use inside async code (e.g. FastAPI, asyncio scripts):

```python
from orchestrator_client import OrchestratorAsync

async with OrchestratorAsync() as client:
    status = await client.get_task_status("task-abc123")

Exceptions

All inherit from OrchestratorError and carry status_code and error_code:

Exception	Meaning
`OrchestratorConnectionError`	Network / DNS / timeout
`OrchestratorAuthError`	401/403
`OrchestratorNotFoundError`	404
`OrchestratorAPIError`	400/500 with error code
`OrchestratorConfigError`	Bad env vars / missing config

Documentation

Detailed docs with full method listings and examples:

REST API client — all endpoints, workflow interactions, configuration
Socket.IO realtime — event types, room subscriptions, streaming
SSE status stream — lightweight status-only monitoring

Testing

pip install -e ".[dev]"
pytest

License

Apache 2.0

Metadata

Release files for orchestrator-client 5.12.2

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for orchestrator-client 5.12.2
File	Size	Uploaded
orchestrator_client-5.12.2.tar.gz	64.0 kB	Sep 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for orchestrator-client 5.12.2
File	Interpreter	ABI	Platform	Reset
orchestrator_client-5.12.2-py3-none-any.whl 54.3 kB Sep 4, 2026	Python 3	none	any	Details

Total release size: 118.3 kB

Release files / orchestrator_client-5.12.2.tar.gz

Download URL	orchestrator_client-5.12.2.tar.gz
Size	64.0 kB
Tags	Source
SHA-256 checksum How to use checksums	`d49ba4d54242f06045762e0ff8429272935b6174b055156382c0b7366abb1c89`
BLAKE2b-256 checksum How to use checksums	`a4c4010eb3324ff036a13e6c808ab6712ee9f5debbc7c1d3bd429335d7cb4e83`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/DamitDev/orchestrator
Publishing commit: github.com/DamitDev/orchestrator/tree/4c99cbe2ef65799b0f432d182048fcb81b5b3c3d

Workflow

Publishing configuration: github.com/DamitDev/orchestrator/blob/4c99cbe2ef65799b0f432d182048fcb81b5b3c3d/.github/workflows/client-py-publish.yaml
Publishing logs: github.com/DamitDev/orchestrator/actions/runs/33863788117/attempts/1

Artifact

Subject: orchestrator_client-5.12.2.tar.gz
SHA-256 checksum: d49ba4d54242f06045762e0ff8429272935b6174b055156382c0b7366abb1c89 Verifying attestations

Release files / orchestrator_client-5.12.2-py3-none-any.whl

Download URL	orchestrator_client-5.12.2-py3-none-any.whl
Size	54.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`0be6e84564c35919be0c286e11f954cad66af6bfedffb9869463e54f241a564e`
BLAKE2b-256 checksum How to use checksums	`5e82f0700b6a93f3998783a2c76e3a7df0a0484aaa88e666a1fe1fc3d44b4257`
Upload date	Sep 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/DamitDev/orchestrator
Publishing commit: github.com/DamitDev/orchestrator/tree/4c99cbe2ef65799b0f432d182048fcb81b5b3c3d

Workflow

Publishing configuration: github.com/DamitDev/orchestrator/blob/4c99cbe2ef65799b0f432d182048fcb81b5b3c3d/.github/workflows/client-py-publish.yaml
Publishing logs: github.com/DamitDev/orchestrator/actions/runs/33863788117/attempts/1

Artifact

Subject: orchestrator_client-5.12.2-py3-none-any.whl
SHA-256 checksum: 0be6e84564c35919be0c286e11f954cad66af6bfedffb9869463e54f241a564e Verifying attestations