Modified start.rst from pip to uv. #46316

docs/apache-airflow/start.rst

@@ -26,69 +26,61 @@ This quick start guide will help you bootstrap an Airflow standalone instance on
 
    Successful installation requires a Python 3 environment. Starting with Airflow 2.7.0, Airflow supports Python 3.9, 3.10, 3.11, and 3.12.
 
-   Only ``pip`` installation is currently officially supported.
+   Officially supported installation methods include ``pip`` and ``uv``. Both tools provide a streamlined workflow for installing Airflow and managing dependencies.
+
+
 
    While there have been successes with using other tools like `poetry <https://python-poetry.org/>`_ or
    `pip-tools <https://pypi.org/project/pip-tools/>`_, they do not share the same workflow as
-   ``pip`` - especially when it comes to constraint vs. requirements management.
+   ``pip`` or ``uv`` - especially when it comes to constraint vs. requirements management.
    Installing via ``Poetry`` or ``pip-tools`` is not currently supported.
 
    There are known issues with ``bazel`` that might lead to circular dependencies when using it to install
-   Airflow. Please switch to ``pip`` if you encounter such problems. ``Bazel`` community works on fixing
+   Airflow. Please switch to ``pip`` or ``uv`` if you encounter such problems. ``Bazel`` community works on fixing
    the problem in `this PR <https://github.com/bazelbuild/rules_python/pull/1166>`_ so it might be that
    newer versions of ``bazel`` will handle it.
 
    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.
 
-The installation of Airflow is straightforward if you follow the instructions below. Airflow uses
-constraint files to enable reproducible installation, so using ``pip`` and constraint files is recommended.
-
-1. **(Recommended) Create and Activate a Virtual Environment**:
+   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.
 
-   To avoid issues such as the ``externally-managed-environment`` error, particularly on modern Linux distributions like Ubuntu 22.04+ and Debian 12+, it is highly recommended to install Airflow inside a Python virtual environment. This approach prevents conflicts with system-level Python packages and ensures smooth installation.
+1. **Set Airflow Home (optional)**:
 
-   For more details on this error, see the Python Packaging Authority's explanation in the `PEP 668 documentation <https://peps.python.org/pep-0668/>`_.
+   Airflow requires a home directory, and uses ``~/airflow`` by default, but you can set a different location if you prefer. The ``AIRFLOW_HOME`` environment variable is used to inform Airflow of the desired location. This step of setting the environment variable should be done before installing Airflow so that the installation process knows where to store the necessary files.
 
    .. code-block:: bash
 
-      # Create a virtual environment in your desired directory
-      python3 -m venv airflow_venv
-
-      # Activate the virtual environment
-      source airflow_venv/bin/activate
-
-      # Upgrade pip within the virtual environment
-      pip install --upgrade pip
-
-      # Optional: Deactivate the virtual environment when done
-      deactivate
+      export AIRFLOW_HOME=~/airflow
 
-2. **Set Airflow Home (optional)**:
+2.  Install Airflow Using uv:
 
-   Airflow requires a home directory, and uses ``~/airflow`` by default, but you can set a different location if you prefer. The ``AIRFLOW_HOME`` environment variable is used to inform Airflow of the desired location. This step of setting the environment variable should be done before installing Airflow so that the installation process knows where to store the necessary files.
+    .. rst-class:: centered
 
-   .. code-block:: bash
-
-      export AIRFLOW_HOME=~/airflow
+        Install uv: `uv Installation Guide <https://docs.astral.sh/uv/getting-started/installation/>`_
 
 
+    For creating Virtualenv with uv, refer to the documentation here: 
+    `Creating and Maintaining Local Virtualenv with uv <https://github.com/apache/airflow/blob/main/contributing-docs/07_local_virtualenv.rst#creating-and-maintaining-local-virtualenv-with-uv>`_
+
+
 3. Install Airflow using the constraints file, which is determined based on the URL we pass:
 
    .. code-block:: bash
       :substitutions:
 
 
-      AIRFLOW_VERSION=|version|
+      AIRFLOW_VERSION=2.10.5
 
       # Extract the version of Python you have installed. If you're currently using a Python version that is not supported by Airflow, you may want to set this manually.
       # See above for supported versions.
       PYTHON_VERSION="$(python -c 'import sys; print(f"{sys.version_info.major}.{sys.version_info.minor}")')"
 
       CONSTRAINT_URL="https://raw.githubusercontent.com/apache/airflow/constraints-${AIRFLOW_VERSION}/constraints-${PYTHON_VERSION}.txt"
-      # For example this would install |version| with python 3.9: https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt
+      # For example this would install 2.10.5 with python 3.9: https://raw.githubusercontent.com/apache/airflow/constraints-|version|/constraints-3.9.txt
 
-      pip install "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"
+      uv pip install "apache-airflow==${AIRFLOW_VERSION}" --constraint "${CONSTRAINT_URL}"
 
 4. Run Airflow Standalone: