airflow-balancer

Select configured hosts and ports for Airflow tasks, generate SSH hooks, and inspect configuration in a viewer. Core models come from airflow-pydantic; YAML composition comes from airflow-config.

Python 3.11 or later is required. Install the package for configuration loading, or choose the extra for your Airflow version:

pip install airflow-balancer
pip install 'airflow-balancer[airflow]'   # Airflow 2
pip install 'airflow-balancer[airflow3]'  # Airflow 3

For conda-forge:

conda install -c conda-forge airflow-balancer

• Tutorial: select a worker and inspect its configuration

• How-to guides: Python, YAML, SSH, pools, and the viewer

• Reference: models, queries, loading, and viewer settings

• Explanation: selection, pool limits, and port availability

Selection chooses randomly among matching configured hosts. free_port() excludes ports listed in configuration. The explanation describes how these choices relate to Airflow scheduling and resource ownership.

Documentation · Source · Issues

License

Apache 2.0. See LICENSE.