This is an automated email from the ASF dual-hosted git repository.
rahulvats pushed a commit to branch v3-2-test
in repository https://gitbox.apache.org/repos/asf/airflow.git
The following commit(s) were added to refs/heads/v3-2-test by this push:
new 1882da44c1d [v3-2-test] Allow direct execution from airflow standalone
via uvx (#64405) (#64432)
1882da44c1d is described below
commit 1882da44c1d03ca8579936d25847a809215e8cb7
Author: github-actions[bot]
<41898282+github-actions[bot]@users.noreply.github.com>
AuthorDate: Mon Mar 30 12:38:08 2026 +0530
[v3-2-test] Allow direct execution from airflow standalone via uvx (#64405)
(#64432)
* Allow direct execution from airflow standalone via uvx
* Fix docsbuild
* Revise documentation
* Spellcheck fix documentation
(cherry picked from commit d71755e5e5b2e65694d1795dac7c631da7f6c46c)
Co-authored-by: Jens Scheffler <[email protected]>
Co-authored-by: Rahul Vats <[email protected]>
---
airflow-core/docs/installation/index.rst | 22 +++++++++++++++++
.../docs/installation/installing-from-pypi.rst | 28 ++++++++++++++++++++--
pyproject.toml | 4 ++++
3 files changed, 52 insertions(+), 2 deletions(-)
diff --git a/airflow-core/docs/installation/index.rst
b/airflow-core/docs/installation/index.rst
index b033a091070..c3737c15bd6 100644
--- a/airflow-core/docs/installation/index.rst
+++ b/airflow-core/docs/installation/index.rst
@@ -49,6 +49,28 @@ via extras and providers.
When you install Airflow, you need to :doc:`setup the database
<setting-up-the-database>` which must
also be kept updated when Airflow is upgraded.
+Local start for development and testing
+'''''''''''''''''''''''''''''''''''''''
+
+You just want to try Apache Airflow without all production complexity? If you
have ``pipx`` installed,
+you can install Airflow directly from PyPI with the command below:
+
+.. code-block:: bash
+
+ pipx run apache-airflow standalone
+
+Alternatively similar with Astral ``uv``:
+
+.. code-block:: bash
+
+ uvx apache-airflow standalone
+
+Which starts a minimal system with an auto-generated admin password and SQLite
database, so you can
+start using Airflow right away. This is a great way to get familiar with
Airflow and try it out
+without the need to set up a complex environment.
+
+Note that the standalone mode is not for production purposes. But it is a
simple start for a local development.
+
Using released sources
''''''''''''''''''''''
diff --git a/airflow-core/docs/installation/installing-from-pypi.rst
b/airflow-core/docs/installation/installing-from-pypi.rst
index 1815cd246a3..bfcd1d4e9c4 100644
--- a/airflow-core/docs/installation/installing-from-pypi.rst
+++ b/airflow-core/docs/installation/installing-from-pypi.rst
@@ -21,8 +21,32 @@ Installation from PyPI
This page describes installations using the ``apache-airflow`` package
`published in
PyPI <https://pypi.org/project/apache-airflow/>`__.
-Installation tools
-''''''''''''''''''
+Installation via ``pipx`` or ``uv`` as tool
+'''''''''''''''''''''''''''''''''''''''''''
+
+For a local development and testing environment, you can install and run
Apache Airflow directly from PyPI.
+
+If you use ``pipx`` you can run directly from PyPI with the command below:
+
+.. code-block:: bash
+
+ pipx run "apache-airflow==|version|" standalone
+
+Via Astral ``uv`` it is possible to install from PyPI using:
+
+.. code-block:: bash
+
+ uv tool install "apache-airflow==|version|"
+
+Additionally to jump-start using it you can also use the shortcut via ``uvx``
command and directly run it without installing it first:
+
+.. code-block:: bash
+
+ uvx apache-airflow standalone
+
+
+Installation in your environment
+''''''''''''''''''''''''''''''''
Only ``pip`` and ``uv`` installation is currently officially supported.
diff --git a/pyproject.toml b/pyproject.toml
index f3353f76c12..48ccb3a9f6e 100644
--- a/pyproject.toml
+++ b/pyproject.toml
@@ -65,6 +65,10 @@ dependencies = [
packages = []
+[project.scripts]
+# Definition allowing direct execution via `uvx apache-airflow ...`
+apache-airflow = "airflow.__main__:main"
+
[project.optional-dependencies]
# Automatically generated airflow optional dependencies
(update_airflow_pyproject_toml.py)
"all-core" = [
