From 3368e54bcf1c6b59074212441c30c93be4656135 Mon Sep 17 00:00:00 2001
From: fderuiter <127706008+fderuiter@users.noreply.github.com>
Date: Tue, 24 Feb 2026 22:29:18 +0000
Subject: [PATCH] docs: fix broken airflow installation instructions

Update README.md and docs/airflow.rst to instruct users to manually install `apache-airflow` and `apache-airflow-providers-amazon` instead of relying on the broken `imednet[airflow]` extra.

The `airflow` extra in `pyproject.toml` is non-functional due to version conflicts with `werkzeug` (dev dependency), preventing automatic installation. Explicit manual installation ensures users can successfully set up the Airflow integration.

Co-authored-by: google-labs-jules[bot] <161369871+google-labs-jules[bot]@users.noreply.github.com>
---
 README.md        | 4 ++--
 docs/airflow.rst | 4 ++--
 2 files changed, 4 insertions(+), 4 deletions(-)

diff --git a/README.md b/README.md
index f97d1cf8..b4e35ac7 100644
--- a/README.md
+++ b/README.md
@@ -73,8 +73,8 @@ pip install "imednet[sqlalchemy]"  # For SQL export
 pip install "imednet[pyarrow]"     # For Parquet export
 pip install "imednet[excel]"       # For Excel export
 
-# For Airflow integration (apache-airflow must be installed manually due to version conflicts)
-pip install "imednet[airflow]" apache-airflow apache-airflow-providers-amazon
+# For Airflow integration (must be installed manually due to version conflicts)
+pip install imednet apache-airflow apache-airflow-providers-amazon
 ```
 
 ### Development Version
diff --git a/docs/airflow.rst b/docs/airflow.rst
index a1a710ae..b1dd0d79 100644
--- a/docs/airflow.rst
+++ b/docs/airflow.rst
@@ -6,11 +6,11 @@ The SDK ships with operators and sensors for building Airflow pipelines.
 Installation
 ------------
 
-Install the SDK with the Airflow extra:
+Install the SDK along with Airflow dependencies manually (due to version conflicts, the Airflow packages cannot be managed automatically):
 
 .. code-block:: bash
 
-   pip install "imednet[airflow]"
+   pip install imednet apache-airflow apache-airflow-providers-amazon
 
 Example DAG
 -----------