Quick Start
This quick start guide will help you bootstrap an Airflow standalone instance on your local machine.
Note
Successful installation requires a Python 3 environment. Starting with Airflow 3.2.0, Airflow supports Python 3.10, 3.11, 3.12, 3.13, 3.14.
Officially supported installation methods are pip or uv.
Run pip install apache-airflow[EXTRAS]==AIRFLOW_VERSION --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-AIRFLOW_VERSION/constraints-PYTHON_VERSION.txt", for example pip install "apache-airflow[celery]==3.0.0" --constraint "https://raw.githubusercontent.com/apache/airflow/constraints-3.0.0/constraints-3.10.txt" to install Airflow in a reproducible way. You can also use - much faster - uv - by adding uv before the command.
While there have been successes with using other tools like poetry or
pip-tools, they do not share the same workflow as
pip or uv - especially when it comes to constraint vs. requirements management.
Installing via Poetry or pip-tools is not currently supported.
If you wish to install Airflow using those tools you should use the constraint files and convert them to appropriate format and workflow that your tool requires.
This guide will help you quickly set up Apache Airflow using uv, a fast and modern tool for managing Python environments and dependencies. uv makes the installation process easy and provides a
smooth setup experience.
If you are on Windows, you have to use WSL2 (Linux environment for Windows).