orchestra-sdk
Orchestra SDK for updating self-hosted Tasks.
Decision gist · record as of 2026-08-14
Yes, if you are running self-hosted tasks orchestrated by Orchestra and need to report their status and logs back to the platform. The low install friction and permissive license make adoption straightforward. However, the aging maintenance status (261 days since last release) suggests you should verify that the SDK remains compatible with your Orchestra version and that the project is not in hibernation before committing to production use.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires ORCHESTRA_TASK_RUN_ID environment variable (set by Orchestra) or manual assignment after initialization; API key must be provided or available via environment.
- Low install friction with only two runtime dependencies (requests, tenacity).
- Maintenance status is aging—last release was 261 days ago—so expect slower response to issues or feature requests.
License · maintenance · safety
permissive license (permissive) — MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for commercial and open-source projects alike.
last release 2025-11-26 (261 days)
0 known vulnerabilities (OSV.dev, 2026-08-14) · 172,470 downloads/mo, #10,335 on PyPI
Alternatives
Verify before relying
pip install orchestra-sdk
from orchestra_sdk.orchestra import OrchestraSDK
orchestra = OrchestraSDK(api_key="your_api_key")
@orchestra.run()
def my_task():
print("Task running")
return "result"- Whether the package is actively maintained or in maintenance-only mode despite the aging status.
- Compatibility with Orchestra versions beyond what the SDK was released against.
- Performance characteristics when sending large log files or frequent status updates.
What it is and what it does
Orchestra SDK is a client library that bridges self-hosted task execution environments with the Orchestra workflow orchestration platform. It handles the HTTP communication needed for a task running outside Orchestra's control to report its progress, completion status, logs, and output values back to the platform. The SDK provides both a decorator pattern for automatic lifecycle tracking (sending RUNNING on start, SUCCEEDED or FAILED on completion) and manual methods for fine-grained control over status updates and output setting.
The package is designed for integration into task code that Orchestra triggers asynchronously—typically in self-hosted servers, containers, or AWS Lambda functions. It requires an API key for authentication and a task run ID (usually set by Orchestra as an environment variable) to route updates to the correct workflow execution. Optional log file sending and AWS Lambda-specific configuration helpers reduce boilerplate for common deployment patterns.
Use it for
- Wrap a long-running self-hosted task with the @orchestra.run() decorator to automatically report start, completion, and failure to Orchestra.
- Send intermediate status messages and logs from a task back to Orchestra for visibility into execution progress.
- Set task output values (e.g., result of a computation) that downstream workflow steps can consume.
- Configure a Lambda function handler to extract Orchestra metadata from the event and apply it to the SDK instance.
- Manually control task status updates in complex workflows where decorator automation is insufficient.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are running self-hosted tasks orchestrated by Orchestra and need to report their status and logs back to the platform.
The low install friction and permissive license make adoption straightforward. However, the aging maintenance status (261 days since last release) suggests you should verify that the SDK remains compatible with your Orchestra version and that the project is not in hibernation before committing to production use.
Install
orchestra-sdk on PyPI
Before you install
Low install friction with only two runtime dependencies (requests, tenacity). Maintenance status is aging—last release was 261 days ago—so expect slower response to issues or feature requests.
Requires ORCHESTRA_TASK_RUN_ID environment variable (set by Orchestra) or manual assignment after initialization; API key must be provided or available via environment.
License in practice
MIT license permits free use, modification, and distribution with minimal restrictions, making it suitable for commercial and open-source projects alike.
Quickstart
pip install orchestra-sdk
from orchestra_sdk.orchestra import OrchestraSDK
orchestra = OrchestraSDK(api_key="your_api_key")
@orchestra.run()
def my_task():
print("Task running")
return "result"Verify before relying
- Whether the package is actively maintained or in maintenance-only mode despite the aging status.
- Compatibility with Orchestra versions beyond what the SDK was released against.
- Performance characteristics when sending large log files or frequent status updates.
Package facts
| License | permissive license permissive |
| Python support | Supports the current Python release >=3.8.0 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagesrequeststenacity |
| Maintenance | Aging 261 days since the last release |
| First released | |
| Downloads | 172,470 / month, #10,335 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: MIT LicenseTopic :: Database |
Evidence: orchestra_sdk-0.1.2-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “orchestra task status updates”
- orchestra-sdkA lightweight SDK for self-hosted tasks to send status updates, logs,…
- celery-progressProvides drop-in progress bars for Django views that display…
- apache-airflow-providers-asanaIntegrates Apache Airflow with Asana, enabling workflow automation to…
Give your agent the search over MCP, or paste the wish link into any chat.
More Database packages
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Python client library for connecting to and executing commands against Redis key-value stores, supporting both synchronous and asynchronous operations.
Install it if your application needs to interact with Redis; the only prerequisite is a running Redis server instance.
YDB Python SDK is the official client library for connecting to and querying YDB databases from Python applications.
Install it if you need to connect Python applications to YDB databases.
Connects Python applications to Snowflake data warehouses using the DB API 2.0 specification, enabling SQL queries, data transfers, and warehouse operations.
sqlparse tokenizes SQL text into a tree of statements, clauses, and expressions, and provides functions to split scripts, format queries, and inspect parsed tokens without validating dialect or syntax.
Install it if you need to manipulate, format, or analyze SQL text programmatically.
Provides base adapter protocols and shared functionality that database adapters use to integrate with dbt-core, handling connections, dialect translation, relation caching, and core interface management.
See also python-logging-loki · render_sdk · google-cloud-tasks · logging-azure-rest · aa-taskmonitor · durabletask · label-studio-sdk · durabletask.azuremanaged · loki-logger-handler · apache-airflow-task-sdk