From 973ca8c7809f3477474839b931ce2dd47a820c55 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Thu, 12 Dec 2024 14:01:16 -0500 Subject: [PATCH] Docs: recommend uv (#5237) * docs: add troubleshooting section for Langflow installation issues * docs: update installation instructions to recommend uv for local setup * docs: update installation instructions to emphasize uv as the recommended method * Update docs/docs/Get-Started/get-started-installation.md Co-authored-by: Madhavan --------- Co-authored-by: Madhavan --- README.md | 2 +- .../Get-Started/get-started-installation.md | 18 +++++++++++++++++- 2 files changed, 18 insertions(+), 2 deletions(-) diff --git a/README.md b/README.md index 4a69f8df4..7de8b40cb 100644 --- a/README.md +++ b/README.md @@ -40,7 +40,7 @@ ## 📦 Quickstart -- **Install with uv** (Python 3.10 to 3.12): +- **Install with uv (recommended)** (Python 3.10 to 3.12): ```shell uv pip install langflow diff --git a/docs/docs/Get-Started/get-started-installation.md b/docs/docs/Get-Started/get-started-installation.md index 08d7f6af5..3308f0748 100644 --- a/docs/docs/Get-Started/get-started-installation.md +++ b/docs/docs/Get-Started/get-started-installation.md @@ -8,7 +8,7 @@ You can deploy Langflow either locally or as a hosted service with [**Datastax L ## Install Langflow locally -Install Langflow locally with [uv](https://docs.astral.sh/uv/getting-started/installation/), [pip](https://pypi.org/project/pip/), or [pipx](https://pipx.pypa.io/stable/installation/). +Install Langflow locally with [uv (recommended)](https://docs.astral.sh/uv/getting-started/installation/), [pip](https://pypi.org/project/pip/), or [pipx](https://pipx.pypa.io/stable/installation/). ### Prerequisites @@ -128,6 +128,22 @@ This error can occur during Langflow upgrades when the new version can't overrid If you wish to retain your files, back them up before clearing the folder. +### Langflow installation freezes at pip dependency resolution +Installing Langflow with `pip install langflow` slowly fails with this error message: +```plain +pip is looking at multiple versions of <> to determine which version is compatible with other requirements. This could take a while. +``` +To work around this issue, install Langflow with [`uv`](https://docs.astral.sh/uv/getting-started/installation/) instead of `pip`. + +```plain +uv pip install langflow +``` + +To run Langflow with uv: + +```plain +uv run langflow run +``` \ No newline at end of file