apache-airflow-providers-openai
Changelog¶
1.8.2¶
Release Date: 2026-08-03
Note
OpenAITriggerBatchOperator now fails the task when a deferred batch ends in a
non-success state. Previously only status="error" raised, so a batch that was
cancelled while the task was deferred completed successfully with no results,
and an unrecognized or missing trigger event either succeeded silently or crashed with
TypeError: 'NoneType' object is not subscriptable.
This aligns the deferrable path with the non-deferrable one, which has raised for
CANCELLED/CANCELLING since OpenAIHook.wait_for_batch was fixed.
Dags whose batches are cancelled will now fail where they previously reported success.
That is the intended correction — the earlier green runs produced no batch output — but
if you were relying on cancellation being treated as success, handle it explicitly, for
example with a trigger rule or by catching OpenAIBatchJobException downstream.
Bug Fixes¶
Use monotonic clock for OpenAIBatchTrigger polling timeout (#69534)Validate trigger events in Openai deferrable tasks (#69506)
1.8.1¶
Release Date: 2026-07-28
Note
The [datalib] extra of the openai SDK is no longer part of this
provider’s base install. That extra existed to support the SDK’s legacy
openai tools fine_tunes.prepare_data CLI (removed in openai 1.x) and
transitively pulled in numpy, pandas, and pandas-stubs for every
provider user. None of these packages are imported by the provider’s
source, tests, or example Dags, so the extra was pure transitive bloat.
Users whose Dag code relied on numpy or pandas being installed as a
side-effect of installing this provider should declare those packages
explicitly, or install the SDK extra directly:
pip install 'openai[datalib]'
Misc¶
Remove unused [datalib] extra from OpenAI provider base install (#69408)
Doc-only¶
Fix broken class references and truncated wording in OpenAI provider docs (#69710)Add feature-comparison table and toolset links to common.ai provider docs (#69649)Add quickstart to OpenAI provider (#69590)Document when to use common.ai vs vendor-specific AI providers (#69551)
OpenAIBatchTrigger now measures its polling timeout with
time.monotonic() instead of time.time(), so a batch task’s
timeout is no longer affected by wall-clock adjustments (NTP corrections,
DST, VM pause/resume) that happen while the trigger is deferred.
To make that possible the trigger’s preferred constructor argument changed
from end_time (an absolute wall-clock deadline) to timeout (a
duration in seconds). OpenAITriggerBatchOperator has been updated to
pass timeout. OpenAIBatchTrigger still accepts the legacy
end_time argument so that triggers serialized by the previous version
of the operator continue to run after an upgrade; direct users of the
trigger should switch to timeout.
1.8.0¶
Release Date: 2026-07-10
Features¶
Deprecate OpenAI Assistants and Threads hook methods (#69071)Add OpenAI Responses and Conversations support (#69070)Add Workload Identity authentication to OpenAI provider (#69069)
Misc¶
Update OpenAI provider to OpenAI Python SDK 2.x (#69068)
1.7.5¶
Release Date: 2026-06-07
Misc¶
Add explicit [tool.flit.sdist] sections to flit-based pyproject.tomls (#65861)
1.7.4¶
Release Date: 2026-04-12
Misc¶
Load hook metadata from YAML without importing Hook class (#63826)
1.7.3¶
Release Date: 2026-03-28
Bug Fixes¶
Fix OpenAI provider get_provider_info (#63404)Fix CI regression of "Improve OpenAI provider metadata" (#63403)
Misc¶
Add Python 3.14 Support (#63520)Improve OpenAI provider metadata and documentation (#61054)Migrate OpenAI connection UI metadata to YAML (#62669)
1.7.2¶
Release Date: 2026-01-17
Misc¶
New year means updated Copyright notices (#60344)Migrate openai provider to use airflow.sdk.configuration.conf (#59996)
1.7.1¶
Release Date: 2025-12-13
Misc¶
Add backcompat for exceptions in providers (#58727)
1.7.0¶
Release Date: 2025-11-30
Note
This release of provider is only available for Airflow 2.11+ as explained in the Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.
Misc¶
Bump minimum Airflow version in providers to Airflow 2.11.0 (#58612)
1.6.4¶
Release Date: 2025-11-17
Misc¶
Convert all airflow distributions to be compliant with ASF requirements (#58138)
1.6.3¶
Release Date: 2025-10-26
Misc¶
Migrate openai provider to ''common.compat'' (#57020)
Doc-only¶
Remove placeholder Release Date in changelog and index files (#56056)
1.6.2¶
Release Date: 2025-08-02
Misc¶
Add Python 3.13 support for Airflow. (#46891)Cleanup type ignores in openai provider where possible (#53285)Remove type ignore across codebase after mypy upgrade (#53243)Remove upper-binding for "python-requires" (#52980)Temporarily switch to use >=,< pattern instead of '~=' (#52967)Move all BaseHook usages to version_compat in openai (#52819)
1.6.1¶
Release Date: 2025-07-06
Misc¶
Move 'BaseHook' implementation to task SDK (#51873)Disable UP038 ruff rule and revert mandatory 'X | Y' in insintance checks (#52644)Provider Migration: Replace 'BaseOperator' to Task SDK for 'OpenAI' (#52561)Drop support for Python 3.9 (#52072)
1.6.0¶
Release Date: 2025-05-18
Note
This release of provider is only available for Airflow 2.10+ as explained in the Apache Airflow providers support policy <https://github.com/apache/airflow/blob/main/PROVIDERS.rst#minimum-supported-version-of-airflow-for-community-managed-providers>_.
Misc¶
Bump min Airflow version in providers to 2.10 (#49843)
1.5.4¶
Release Date: 2025-04-19
Misc¶
remove superfluous else block (#49199)
1.5.3¶
Release Date: 2025-03-31
Misc¶
Make open ai provider compatible with openai>=1.66.0 (#47726)
1.5.2¶
Release Date: 2025-03-13
Misc¶
Upgrade flit to 3.11.0 (#46938)
1.5.1¶
Release Date: 2025-02-26
Misc¶
AIP-72: Support better type-hinting for Context dict in SDK (#45583)
1.5.0¶
Release Date: 2024-12-26
Note
This release of provider is only available for Airflow 2.9+ as explained in the Apache Airflow providers support policy.
Misc¶
Bump minimum Airflow version in providers to Airflow 2.9.0 (#44956)
1.4.0¶
Release Date: 2024-09-24
Features¶
feat(providers/openai): support batch api in hook/operator/trigger (#41554)
1.3.0¶
Release Date: 2024-08-22
Note
This release of provider is only available for Airflow 2.8+ as explained in the Apache Airflow providers support policy.
Misc¶
Bump minimum Airflow version in providers to Airflow 2.8.0 (#41396)
1.2.2¶
Release Date: 2024-06-27
Misc¶
Bump openai minimum version to openai (#40110)
1.2.1¶
Release Date: 2024-05-30
Misc¶
Faster 'airflow_version' imports (#39552)Simplify 'airflow_version' imports (#39497)
1.2.0¶
Release Date: 2024-05-06
Note
This release of provider is only available for Airflow 2.7+ as explained in the Apache Airflow providers support policy.
Features¶
OpenAI Chat & Assistant hook functions (#38736)OpenAI Files & Vector Store Hooks (#39248)
Misc¶
Bump minimum Airflow version in providers to Airflow 2.7.0 (#39240)
1.1.0¶
Release Date: 2023-12-12
Note
This release of provider is only available for Airflow 2.6+ as explained in the Apache Airflow providers support policy.
Misc¶
Bump minimum Airflow version in providers to Airflow 2.6.0 (#36017)Bump up openai version to >=1.0 & use get_conn (#36014)
1.0.1¶
Release Date: 2023-11-29
Misc¶
Refine Type Handling in OpenAI Embedding Operator to Match OpenAI Typings (#35547)
1.0.0¶
Release Date: 2023-11-12
Initial version of the provider.