potiuk commented on code in PR #46761:
URL: https://github.com/apache/airflow/pull/46761#discussion_r1956170095
##########
docs/apache-airflow/start.rst:
##########
@@ -90,15 +70,36 @@ constraint files to enable reproducible installation, so
using ``pip`` and const
pip install "apache-airflow==${AIRFLOW_VERSION}" --constraint
"${CONSTRAINT_URL}"
-4. Run Airflow Standalone:
+.. note::
+ Here you will face an error, *error: externally-managed-environment*. This
error usually occurs when you try to install python package globally using
``pip``. More details are on `PEP 668 <https://peps.python.org/pep-0668/>`_.
+ We would recommend creating a virtual environment before running the ``pip
install`` command. This will prevent affecting the system python installation.
Review Comment:
Actually, I think it's a good time to recommend and explain `uv` workflow
here, and leave `pip` as alternative. See the
https://github.com/apache/airflow/blob/main/contributing-docs/07_local_virtualenv.rst#creating-and-maintaining-local-virtualenv-with-uv
The `uv` workflow is much better for first-time users (and also even for
experienced Pythonistas) - we have all the configuration that we need now to
run `uv sync` -> which will do everything for you - install Python, create a
venv and allow you to run airlfow using those transparently using `uv run`. So
while you are updating the quick start, I thin it's good to make it "first
class citizen" here.
--
This is an automated message from the Apache Git Service.
To respond to the message, please log on to GitHub and use the
URL above to go to the specific comment.
To unsubscribe, e-mail: [email protected]
For queries about this service, please contact Infrastructure at:
[email protected]
