From 248975c25ccedf3d807abb9a81400bb699a2de04 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:00:38 -0500 Subject: [PATCH 01/12] add-troubleshooting-items-from-scarf --- docs/docs/Support/troubleshooting.mdx | 97 ++++++++++++++++++++++++++- 1 file changed, 94 insertions(+), 3 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 2f70200c2cde..365319b34bea 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -81,9 +81,100 @@ sudo apt-get install gcc If you experience an error from the `webrtcvad` package, run `uv pip install webrtcvad-wheels` in your virtual environment, and then retry the Langflow installation. -### C++ build tools required for Langflow Desktop on Windows +## Langflow Desktop installation issues -Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or [install Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). +The following issues can occur when Langflow Desktop is setting up or installing Langflow OSS automatically during first-time setup or updates. + +To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). + +### [Windows] Failed to install Langflow OSS - Missing C++ Build Tools + +Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. +If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). + +### Failed to install Langflow OSS: Unable to sanity check Langflow OSS version + +Desktop installed Langflow OSS but couldn't verify the installation. + +To resolve this error, do the following: + +1. Close Langflow Desktop. +2. Clear Langflow Desktop's Python virtual environment. + Navigate to Langflow Desktop's data directory at `%LOCALAPPDATA%\com.LangflowDesktop` on Windows, or `~/Library/Application Support/com.LangflowDesktop` on macOS. +3. Delete the `venv` or `python_env` folder. +4. Restart Langflow Desktop. + +If the issue persists, ensure Python 3.9+ is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). + +### Langflow OSS health check failed + +Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. + +To resolve this error, do the following: + +1. Check if another process is using Langflow Desktop's default port `7860`. + * On Windows, run `netstat -ano | findstr :7860`. + * On macOS or Linux, run `lsof -i :7860`. +2. If another process is using the port, stop that process or [configure Langflow Desktop to use a different port](/environment-variables#set-environment-variables-for-langflow-desktop). + +### [Windows] All automatic installation strategies failed + +Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. + +To resolve this error, do the following: + +1. Install `uv` manually using PowerShell: + ```powershell + powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" + ``` + + Or install using pip: + ```bash + pip install uv + ``` + +2. Verify the installation by running `uv --version` in a new PowerShell or Command Prompt window. + + If `uv` is not found, add it to your PATH. In PowerShell, run: + ```powershell + [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User") + ``` + +3. Restart Langflow Desktop. + +### Failed to install uv: Unable to find uv executable + +This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. + +Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed. + +To resolve this error, do the following: + +1. Verify `uv` is installed by running `uv --version` in a terminal. +2. If `uv` is not found, install `uv` using the instructions in [[Windows] All automatic installation strategies failed](#windows-all-automatic-installation-strategies-failed), or see the [uv installation guide](https://github.com/astral-sh/uv#installation). +3. If `uv` is installed but not found, add it to your PATH environment variable: + * Windows: Add `%USERPROFILE%\.cargo\bin` to your PATH. In PowerShell, run: + ```powershell + [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User") + ``` + * macOS or Linux: Add `~/.cargo/bin` to your PATH in `~/.bashrc` or `~/.zshrc`. + +4. Restart Langflow Desktop. + +### [MacOS] Failed to install Langflow OSS: Xcode Command Line Tools are not installed + +Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. + +To install XCode Command Line Tools manually, do the following: + +1. Open a terminal and run `xcode-select --install`. +2. **The installation may take over 20 minutes**. +To start the installation process, in the popup dialogue, click **Install**. +3. Verify the installation by opening a new terminal and running `xcode-select -p`. + The command should return a path like `/Library/Developer/CommandLineTools`. +4. Restart Langflow Desktop. + +If the manual installation doesn't resolve the issue, download Xcode Command Line Tools from [Apple Developer Downloads](https://developer.apple.com/download/all/), and install the `.dmg` file manually. ## Langflow startup issues @@ -97,7 +188,7 @@ When you try to run Langflow with the command `langflow run`, you encounter the > No module named 'langflow.__main__' ``` -To resolve this issue, try the following: +To resolve this issue, do the following: 1. Run `uv run langflow run` instead of `langflow run`. 2. If that doesn't work, reinstall the latest Langflow version with `uv pip install langflow -U`. From c1800d2dbb50c3636490bf0ba50acdaf90374251 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:02:01 -0500 Subject: [PATCH 02/12] sort-desktop-errors-by-os --- docs/docs/Support/troubleshooting.mdx | 62 +++++++++++++-------------- 1 file changed, 31 insertions(+), 31 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 365319b34bea..f1bbf5461c5e 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -87,11 +87,6 @@ The following issues can occur when Langflow Desktop is setting up or installing To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). -### [Windows] Failed to install Langflow OSS - Missing C++ Build Tools - -Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. -If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). - ### Failed to install Langflow OSS: Unable to sanity check Langflow OSS version Desktop installed Langflow OSS but couldn't verify the installation. @@ -117,31 +112,6 @@ To resolve this error, do the following: * On macOS or Linux, run `lsof -i :7860`. 2. If another process is using the port, stop that process or [configure Langflow Desktop to use a different port](/environment-variables#set-environment-variables-for-langflow-desktop). -### [Windows] All automatic installation strategies failed - -Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. - -To resolve this error, do the following: - -1. Install `uv` manually using PowerShell: - ```powershell - powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" - ``` - - Or install using pip: - ```bash - pip install uv - ``` - -2. Verify the installation by running `uv --version` in a new PowerShell or Command Prompt window. - - If `uv` is not found, add it to your PATH. In PowerShell, run: - ```powershell - [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User") - ``` - -3. Restart Langflow Desktop. - ### Failed to install uv: Unable to find uv executable This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. @@ -151,7 +121,7 @@ Langflow Desktop can't locate the `uv` executable on your system, even though it To resolve this error, do the following: 1. Verify `uv` is installed by running `uv --version` in a terminal. -2. If `uv` is not found, install `uv` using the instructions in [[Windows] All automatic installation strategies failed](#windows-all-automatic-installation-strategies-failed), or see the [uv installation guide](https://github.com/astral-sh/uv#installation). +2. If `uv` is not found, install `uv` using the instructions in "[Windows] All automatic installation strategies failed" below, or see the [uv installation guide](https://github.com/astral-sh/uv#installation). 3. If `uv` is installed but not found, add it to your PATH environment variable: * Windows: Add `%USERPROFILE%\.cargo\bin` to your PATH. In PowerShell, run: ```powershell @@ -176,6 +146,36 @@ To start the installation process, in the popup dialogue, click **Install**. If the manual installation doesn't resolve the issue, download Xcode Command Line Tools from [Apple Developer Downloads](https://developer.apple.com/download/all/), and install the `.dmg` file manually. +### [Windows] Failed to install Langflow OSS - Missing C++ Build Tools + +Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. +If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). + +### [Windows] All automatic installation strategies failed + +Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. + +To resolve this error, do the following: + +1. Install `uv` manually using PowerShell: + ```powershell + powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" + ``` + + Or install using pip: + ```bash + pip install uv + ``` + +2. Verify the installation by running `uv --version` in a new PowerShell or Command Prompt window. + + If `uv` is not found, add it to your PATH. In PowerShell, run: + ```powershell + [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User") + ``` + +3. Restart Langflow Desktop. + ## Langflow startup issues The following issues can occur when attempting to start Langflow. From d385ccc34853406c0ac4a3db879c020ba6b65d27 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:39:12 -0500 Subject: [PATCH 03/12] include-err-strings --- docs/docs/Support/troubleshooting.mdx | 34 ++++++++++++++++++++++----- 1 file changed, 28 insertions(+), 6 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index f1bbf5461c5e..01b857d8da1b 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -89,7 +89,7 @@ To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). ### Failed to install Langflow OSS: Unable to sanity check Langflow OSS version -Desktop installed Langflow OSS but couldn't verify the installation. +Desktop installed Langflow OSS but couldn't verify the installation. You may see the error message: `Langflow Installation Error: langflow-install-error` or `Langflow Installation Error: `. To resolve this error, do the following: @@ -103,7 +103,7 @@ If the issue persists, ensure Python 3.9+ is installed and accessible, or reinst ### Langflow OSS health check failed -Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. +Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see the error message: `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready` or `Langflow Health Check Error: `. To resolve this error, do the following: @@ -114,7 +114,7 @@ To resolve this error, do the following: ### Failed to install uv: Unable to find uv executable -This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. +This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. You may see the error messages: `UV Installation Error: UV installation failed - binary not found after installation` or `Python Environment Error: UV binary not found at: `. Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed. @@ -131,9 +131,31 @@ To resolve this error, do the following: 4. Restart Langflow Desktop. +### Failed to create Python virtual environment + +Desktop failed to create the Python virtual environment required for Langflow OSS. You may see the error message: `Python Environment Error: error_dns`, `Python Environment Error: Creation failed: `, or `Python Environment Error: `. + +To resolve this error, do the following: + +1. Ensure you have sufficient disk space available (at least 2 GB free). +2. Ensure that you have write permissions in the Langflow Desktop data directory: + * On Windows: `%LOCALAPPDATA%\com.LangflowDesktop` + * On macOS: `~/Library/Application Support/com.LangflowDesktop` +3. Close Langflow Desktop. +4. Delete the `venv` or `python_env` folder in the Langflow Desktop data directory. +5. Restart Langflow Desktop. + +If the issue persists, ensure Python 3.9+ is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). + +### Failed to sanity check Python execution + +Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see the error message: `Python Environment Error: Python check failed: ` or `Python Environment Error: `. + +To resolve this error, see [Failed to create Python virtual environment](#failed-to-create-python-virtual-environment). + ### [MacOS] Failed to install Langflow OSS: Xcode Command Line Tools are not installed -Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. +Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. You may see the error message: `Langflow Installation Error: error_xcode` or a detailed message with the title "Xcode Command Line Tools required!". To install XCode Command Line Tools manually, do the following: @@ -149,11 +171,11 @@ If the manual installation doesn't resolve the issue, download Xcode Command Lin ### [Windows] Failed to install Langflow OSS - Missing C++ Build Tools Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. -If you receive a `C++ Build Tools Required!` error, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). +If you receive a `C++ Build Tools Required!` error, see the error message `Langflow Installation Error: error_cpp`, or see a detailed message with the title "C++ Build Tools required!", follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). ### [Windows] All automatic installation strategies failed -Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. +Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see the error message: `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. To resolve this error, do the following: From 42ea7e5cf121bf3f894c17c3902248cf3e117843 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:40:46 -0500 Subject: [PATCH 04/12] casing --- docs/docs/Support/troubleshooting.mdx | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 01b857d8da1b..8e2f8d35878d 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -153,7 +153,7 @@ Desktop created the Python virtual environment but couldn't verify that Python i To resolve this error, see [Failed to create Python virtual environment](#failed-to-create-python-virtual-environment). -### [MacOS] Failed to install Langflow OSS: Xcode Command Line Tools are not installed +### [macOS] Failed to install Langflow OSS: Xcode Command Line Tools are not installed Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. You may see the error message: `Langflow Installation Error: error_xcode` or a detailed message with the title "Xcode Command Line Tools required!". From 157dd22c64056584d96eb681be975fe677be615a Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:43:38 -0500 Subject: [PATCH 05/12] remove-placeholders --- docs/docs/Support/troubleshooting.mdx | 10 +++++----- 1 file changed, 5 insertions(+), 5 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 8e2f8d35878d..9e4d0f083f41 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -89,7 +89,7 @@ To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). ### Failed to install Langflow OSS: Unable to sanity check Langflow OSS version -Desktop installed Langflow OSS but couldn't verify the installation. You may see the error message: `Langflow Installation Error: langflow-install-error` or `Langflow Installation Error: `. +Desktop installed Langflow OSS but couldn't verify the installation. You may see the error message: `Langflow Installation Error: langflow-install-error` or other `Langflow Installation Error:` messages. To resolve this error, do the following: @@ -103,7 +103,7 @@ If the issue persists, ensure Python 3.9+ is installed and accessible, or reinst ### Langflow OSS health check failed -Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see the error message: `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready` or `Langflow Health Check Error: `. +Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see the error message: `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready` or other `Langflow Health Check Error:` messages. To resolve this error, do the following: @@ -114,7 +114,7 @@ To resolve this error, do the following: ### Failed to install uv: Unable to find uv executable -This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. You may see the error messages: `UV Installation Error: UV installation failed - binary not found after installation` or `Python Environment Error: UV binary not found at: `. +This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. You may see the error messages: `UV Installation Error: UV installation failed - binary not found after installation` or `Python Environment Error: UV binary not found at:` followed by a file path. Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed. @@ -133,7 +133,7 @@ To resolve this error, do the following: ### Failed to create Python virtual environment -Desktop failed to create the Python virtual environment required for Langflow OSS. You may see the error message: `Python Environment Error: error_dns`, `Python Environment Error: Creation failed: `, or `Python Environment Error: `. +Desktop failed to create the Python virtual environment required for Langflow OSS. You may see the error message: `Python Environment Error: error_dns`, `Python Environment Error: Creation failed:` followed by error details, or other `Python Environment Error:` messages. To resolve this error, do the following: @@ -149,7 +149,7 @@ If the issue persists, ensure Python 3.9+ is installed and accessible, or reinst ### Failed to sanity check Python execution -Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see the error message: `Python Environment Error: Python check failed: ` or `Python Environment Error: `. +Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see the error message: `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. To resolve this error, see [Failed to create Python virtual environment](#failed-to-create-python-virtual-environment). From 17254e5c50ed140404fba49755ab9a181d2fd428 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 12 Jan 2026 16:49:58 -0500 Subject: [PATCH 06/12] python-version --- docs/docs/Support/troubleshooting.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 9e4d0f083f41..152394024f66 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -99,7 +99,7 @@ To resolve this error, do the following: 3. Delete the `venv` or `python_env` folder. 4. Restart Langflow Desktop. -If the issue persists, ensure Python 3.9+ is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). +If the issue persists, ensure Python version >=3.10 is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). ### Langflow OSS health check failed @@ -145,7 +145,7 @@ To resolve this error, do the following: 4. Delete the `venv` or `python_env` folder in the Langflow Desktop data directory. 5. Restart Langflow Desktop. -If the issue persists, ensure Python 3.9+ is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). +If the issue persists, ensure Python version >=3.10 is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). ### Failed to sanity check Python execution From f7ed2131870bde4103ccbd180f995c222c3ae4d8 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Wed, 14 Jan 2026 14:26:04 -0500 Subject: [PATCH 07/12] Apply suggestions from code review Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com> --- docs/docs/Support/troubleshooting.mdx | 19 +++++++++++-------- 1 file changed, 11 insertions(+), 8 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 152394024f66..096ae253c952 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -99,11 +99,11 @@ To resolve this error, do the following: 3. Delete the `venv` or `python_env` folder. 4. Restart Langflow Desktop. -If the issue persists, ensure Python version >=3.10 is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). +If the issue persists, ensure you have installed Python version 3.10 or later, and it is accessible by your Langflow installation. If the Python version is correct, try reinstalling Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). ### Langflow OSS health check failed -Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see the error message: `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready` or other `Langflow Health Check Error:` messages. +Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You can get health check error messages like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. To resolve this error, do the following: @@ -112,11 +112,14 @@ To resolve this error, do the following: * On macOS or Linux, run `lsof -i :7860`. 2. If another process is using the port, stop that process or [configure Langflow Desktop to use a different port](/environment-variables#set-environment-variables-for-langflow-desktop). -### Failed to install uv: Unable to find uv executable +### Failed to install uv or unable to find uv -This error can also appear as: `Unable to find uv executable for Python virtual environment setup`. You may see the error messages: `UV Installation Error: UV installation failed - binary not found after installation` or `Python Environment Error: UV binary not found at:` followed by a file path. +The following error messages mean that Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed: -Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed. +* `Failed to install uv: Unable to find uv executable` +* `Unable to find uv executable for Python virtual environment setup` +* `UV Installation Error: UV installation failed - binary not found after installation` +* `Python Environment Error: UV binary not found at` To resolve this error, do the following: @@ -153,9 +156,9 @@ Desktop created the Python virtual environment but couldn't verify that Python i To resolve this error, see [Failed to create Python virtual environment](#failed-to-create-python-virtual-environment). -### [macOS] Failed to install Langflow OSS: Xcode Command Line Tools are not installed +### Failed to install Langflow OSS: Xcode Command Line Tools are not installed -Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. You may see the error message: `Langflow Installation Error: error_xcode` or a detailed message with the title "Xcode Command Line Tools required!". +Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. You may see the error message: `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. To install XCode Command Line Tools manually, do the following: @@ -175,7 +178,7 @@ If you receive a `C++ Build Tools Required!` error, see the error message `Langf ### [Windows] All automatic installation strategies failed -Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see the error message: `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. +Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see the error message: `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. To resolve this error, do the following: From b1f97aed8c87f567b9b35a9d2d844676c310fd64 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Wed, 22 Apr 2026 12:42:59 -0400 Subject: [PATCH 08/12] Apply suggestions from code review Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com> --- docs/docs/Support/troubleshooting.mdx | 4 ++-- 1 file changed, 2 insertions(+), 2 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 9a28015becd2..8b3220b9739b 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -183,12 +183,12 @@ To start the installation process, in the popup dialogue, click **Install**. If the manual installation doesn't resolve the issue, download Xcode Command Line Tools from [Apple Developer Downloads](https://developer.apple.com/download/all/), and install the `.dmg` file manually. -### [Windows] Failed to install Langflow OSS - Missing C++ Build Tools +### Failed to install Langflow OSS: Missing C++ Build Tools Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. If you receive a `C++ Build Tools Required!` error, see the error message `Langflow Installation Error: error_cpp`, or see a detailed message with the title "C++ Build Tools required!", follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). -### [Windows] All automatic installation strategies failed +### All automatic installation strategies failed on Windows Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see the error message: `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. From 47946fc1ceb41e57889d8892901fe6f5d115e974 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Fri, 1 May 2026 15:49:27 -0400 Subject: [PATCH 09/12] peer-review --- docs/docs/Support/troubleshooting.mdx | 91 ++++++++++++++++----------- 1 file changed, 55 insertions(+), 36 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 8b3220b9739b..04a0d930324a 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -83,6 +83,10 @@ If you experience an error from the `webrtcvad` package, run `uv pip install web ## Langflow Desktop installation issues +The following issues can occur when Langflow Desktop installs or updates its bundled Langflow OSS instance. + +To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). + ### Protocol buffers (protoc) required for Intel-based Macs If you're installing Langflow on an Intel-based Mac, you may encounter installation errors if Protocol Buffers Compiler (`protoc`) is not installed. @@ -93,15 +97,9 @@ To resolve this issue, install `protoc` using `brew install protobuf`. For more information, including alternative installation methods, see the [Protocol buffers installation documentation](https://protobuf.dev/installation/). -### C++ build tools required for Langflow Desktop on Windows - -The following issues can occur when Langflow Desktop is setting up or installing Langflow OSS automatically during first-time setup or updates. - -To view Langflow Desktop logs, see [Desktop logs](/logging#desktop-logs). - -### Failed to install Langflow OSS: Unable to sanity check Langflow OSS version +### Langflow Installation Error: langflow-install-error -Desktop installed Langflow OSS but couldn't verify the installation. You may see the error message: `Langflow Installation Error: langflow-install-error` or other `Langflow Installation Error:` messages. +Langflow Desktop installed Langflow OSS but couldn't verify the installation. You may see error messages like `Langflow Installation Error: langflow-install-error`. To resolve this error, do the following: @@ -113,9 +111,9 @@ To resolve this error, do the following: If the issue persists, ensure you have installed Python version 3.10 or later, and it is accessible by your Langflow installation. If the Python version is correct, try reinstalling Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). -### Langflow OSS health check failed +### Langflow Health Check Error: Timeout after 80 attempts -Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You can get health check error messages like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. +Langflow Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see an error message like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. To resolve this error, do the following: @@ -135,20 +133,46 @@ The following error messages mean that Langflow Desktop can't locate the `uv` ex To resolve this error, do the following: -1. Verify `uv` is installed by running `uv --version` in a terminal. -2. If `uv` is not found, install `uv` using the instructions in "[Windows] All automatic installation strategies failed" below, or see the [uv installation guide](https://github.com/astral-sh/uv#installation). -3. If `uv` is installed but not found, add it to your PATH environment variable: - * Windows: Add `%USERPROFILE%\.cargo\bin` to your PATH. In PowerShell, run: +1. In a terminal verify `uv` is installed by running `uv --version`. +2. Based on the output, install `uv` or add it to your PATH: + + + + + Install `uv` using one of the following methods: + + * Windows (PowerShell): + ```powershell + powershell -ExecutionPolicy ByPass -c "irm https://astral.sh/uv/install.ps1 | iex" + ``` + * macOS or Linux: + ```bash + curl -LsSf https://astral.sh/uv/install.sh | sh + ``` + * Any platform (pip): + ```bash + pip install uv + ``` + + + + + Add `uv` to your PATH so Langflow Desktop can locate it: + + * Windows: In PowerShell, run: ```powershell [System.Environment]::SetEnvironmentVariable("Path", $env:Path + ";$env:USERPROFILE\.cargo\bin", "User") ``` - * macOS or Linux: Add `~/.cargo/bin` to your PATH in `~/.bashrc` or `~/.zshrc`. + * macOS or Linux: Add `~/.local/bin` to your PATH in `~/.bashrc` or `~/.zshrc`. -4. Restart Langflow Desktop. + + -### Failed to create Python virtual environment +3. Restart Langflow Desktop. + +### Python Environment Error: Creation failed -Desktop failed to create the Python virtual environment required for Langflow OSS. You may see the error message: `Python Environment Error: error_dns`, `Python Environment Error: Creation failed:` followed by error details, or other `Python Environment Error:` messages. +Langflow Desktop failed to create the Python virtual environment required for Langflow OSS. You may see error messages like `Python Environment Error: Creation failed:` followed by error details, `Python Environment Error: error_dns`, or other `Python Environment Error:` messages. To resolve this error, do the following: @@ -162,35 +186,30 @@ To resolve this error, do the following: If the issue persists, ensure Python version >=3.10 is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). -### Failed to sanity check Python execution - -Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see the error message: `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. +### Python Environment Error: Python check failed -To resolve this error, see [Failed to create Python virtual environment](#failed-to-create-python-virtual-environment). +Langflow Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see error messages like `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. -### Failed to install Langflow OSS: Xcode Command Line Tools are not installed +To resolve this error, see [Python Environment Error: Creation failed](#python-environment-error-creation-failed). -Langflow Desktop requires [Xcode Command Line Tools](https://mac.install.guide/commandlinetools/) to install Langflow OSS on macOS. You may see the error message: `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. +### Langflow Installation Error: error_xcode -To install XCode Command Line Tools manually, do the following: +Langflow Desktop requires [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) to install Langflow OSS on macOS. You may see error messages like `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. -1. Open a terminal and run `xcode-select --install`. -2. **The installation may take over 20 minutes**. -To start the installation process, in the popup dialogue, click **Install**. -3. Verify the installation by opening a new terminal and running `xcode-select -p`. - The command should return a path like `/Library/Developer/CommandLineTools`. -4. Restart Langflow Desktop. +To resolve this error, do the following: -If the manual installation doesn't resolve the issue, download Xcode Command Line Tools from [Apple Developer Downloads](https://developer.apple.com/download/all/), and install the `.dmg` file manually. +1. Install [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/). +2. Launch Xcode at least once. Xcode performs additional setup on first startup that other tools such as Git, VS Code, and Langflow Desktop depend on. +3. Restart Langflow Desktop. -### Failed to install Langflow OSS: Missing C++ Build Tools +### Langflow Installation Error: error_cpp Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. -If you receive a `C++ Build Tools Required!` error, see the error message `Langflow Installation Error: error_cpp`, or see a detailed message with the title "C++ Build Tools required!", follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). +If you receive a `Langflow Installation Error: error_cpp` error or a detailed message with the title `C++ Build Tools required!`, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). -### All automatic installation strategies failed on Windows +### UV Installation Error: uv-manual-install-required -Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see the error message: `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. +Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see error messages like `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. To resolve this error, do the following: From c544113b3bb27f788ed8b4c665c7b940b9a2abee Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 4 May 2026 12:16:45 -0400 Subject: [PATCH 10/12] Apply suggestions from code review Co-authored-by: April I. Murphy <36110273+aimurphy@users.noreply.github.com> --- docs/docs/Support/troubleshooting.mdx | 23 +++++++++++------------ 1 file changed, 11 insertions(+), 12 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 04a0d930324a..3d40231a0104 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -99,13 +99,12 @@ For more information, including alternative installation methods, see the [Proto ### Langflow Installation Error: langflow-install-error -Langflow Desktop installed Langflow OSS but couldn't verify the installation. You may see error messages like `Langflow Installation Error: langflow-install-error`. +Langflow Desktop installed Langflow OSS but couldn't verify the installation. You might see error messages like `Langflow Installation Error: langflow-install-error`. -To resolve this error, do the following: +To resolve this error, clear Langflow Desktop's Python virtual environment: 1. Close Langflow Desktop. -2. Clear Langflow Desktop's Python virtual environment. - Navigate to Langflow Desktop's data directory at `%LOCALAPPDATA%\com.LangflowDesktop` on Windows, or `~/Library/Application Support/com.LangflowDesktop` on macOS. +2. Navigate to Langflow Desktop's data directory at `%LOCALAPPDATA%\com.LangflowDesktop` on Windows, or `~/Library/Application Support/com.LangflowDesktop` on macOS. 3. Delete the `venv` or `python_env` folder. 4. Restart Langflow Desktop. @@ -113,7 +112,7 @@ If the issue persists, ensure you have installed Python version 3.10 or later, a ### Langflow Health Check Error: Timeout after 80 attempts -Langflow Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You may see an error message like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. +Langflow Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You might see an error message like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. To resolve this error, do the following: @@ -124,7 +123,7 @@ To resolve this error, do the following: ### Failed to install uv or unable to find uv -The following error messages mean that Langflow Desktop can't locate the `uv` executable on your system, even though it may be installed: +The following error messages mean that Langflow Desktop can't locate the `uv` executable on your system, even if it is installed: * `Failed to install uv: Unable to find uv executable` * `Unable to find uv executable for Python virtual environment setup` @@ -172,7 +171,7 @@ To resolve this error, do the following: ### Python Environment Error: Creation failed -Langflow Desktop failed to create the Python virtual environment required for Langflow OSS. You may see error messages like `Python Environment Error: Creation failed:` followed by error details, `Python Environment Error: error_dns`, or other `Python Environment Error:` messages. +Langflow Desktop failed to create the Python virtual environment required for Langflow OSS. You might see error messages like `Python Environment Error: Creation failed:` followed by error details, `Python Environment Error: error_dns`, or other `Python Environment Error:` messages. To resolve this error, do the following: @@ -184,17 +183,17 @@ To resolve this error, do the following: 4. Delete the `venv` or `python_env` folder in the Langflow Desktop data directory. 5. Restart Langflow Desktop. -If the issue persists, ensure Python version >=3.10 is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). +If the issue persists, ensure Python version 3.10 or later is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). ### Python Environment Error: Python check failed -Langflow Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You may see error messages like `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. +Langflow Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You might see error messages like `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. To resolve this error, see [Python Environment Error: Creation failed](#python-environment-error-creation-failed). ### Langflow Installation Error: error_xcode -Langflow Desktop requires [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) to install Langflow OSS on macOS. You may see error messages like `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. +Langflow Desktop requires [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) to install Langflow OSS on macOS. You might see error messages like `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. To resolve this error, do the following: @@ -204,12 +203,12 @@ To resolve this error, do the following: ### Langflow Installation Error: error_cpp -Microsoft Windows installations of Langflow Desktop require a C++ compiler that may not be present on your system. +Microsoft Windows installations of Langflow Desktop require a C++ compiler that might not be present on your system. If you receive a `Langflow Installation Error: error_cpp` error or a detailed message with the title `C++ Build Tools required!`, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). ### UV Installation Error: uv-manual-install-required -Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You may see error messages like `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. +Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You might see error messages like `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. To resolve this error, do the following: From 1cbe185036f49c57f8d66c6cfd7c6b932d055595 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 4 May 2026 12:34:21 -0400 Subject: [PATCH 11/12] docs-update-some-error-messages-that-have-changed --- docs/docs/Support/troubleshooting.mdx | 26 ++++++++++++++++++++------ 1 file changed, 20 insertions(+), 6 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 3d40231a0104..132d5bdeefa1 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -282,7 +282,8 @@ When running multiple local Langflow OSS instances on different ports, such as ` For example: ```text -[07/22/25 10:57:07] INFO 2025-07-22 10:57:07 - INFO - utils - User not found or inactive. +[07/22/25 10:57:07] INFO 2025-07-22 10:57:07 - INFO - User not found +[07/22/25 10:57:07] INFO 2025-07-22 10:57:07 - INFO - User is inactive ``` To resolve this error, use separate browser instances or browser profiles to access each Langflow instance. @@ -307,7 +308,14 @@ To resolve this issue, remove `asyncpg` from your installation and use `psycopg2 ### PostgreSQL version mismatch: `UNIQUE NULLS DISTINCT` syntax error -The following error can occur when initializing Langflow with a PostgreSQL database: +The following error can occur when initializing Langflow with a PostgreSQL database. +Langflow logs a clear message and then exits: + +```text +Langflow requires PostgreSQL 15 or higher when using PostgreSQL as the database. The current PostgreSQL version does not support the syntax used by Langflow's schema. Please upgrade your PostgreSQL instance to version 15 or higher. +``` + +You may also see the underlying SQL error in the traceback: ```text (psycopg.errors.SyntaxError) syntax error at or near "NULLS" @@ -339,15 +347,21 @@ The following issues can occur when upgrading your Langflow version. For information about managing Langflow versions, see [Install Langflow](/get-started-installation). -### Something went wrong running migrations +### There's a mismatch between the models and the database + +The following error can occur during Langflow upgrades when the database schema doesn't match the current version's models: + +```bash +There's a mismatch between the models and the database. +``` -The following error can occur during Langflow upgrades when the new version can't override `langflow-pre.db` in the Langflow cache folder: +To resolve this error, run the migration fix command: ```bash -> Something went wrong running migrations. Please, run 'langflow migration --fix' +uv run langflow migration --fix ``` -To resolve this error, clear the cache by deleting the contents of your Langflow cache folder. +If the migration fix doesn't resolve the issue, clear the cache by deleting the contents of your Langflow cache folder. The filepath depends on your operating system, installation type, and configuration options. For more information and default filepaths, see [Memory management options](/memory). From b83af30c1c4b0a746a3d05623a9170e9b8c38387 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Mon, 4 May 2026 13:55:45 -0400 Subject: [PATCH 12/12] docs-check-desktop-errors-against-error-constants-file --- docs/docs/Support/troubleshooting.mdx | 37 ++++++++++++--------------- 1 file changed, 16 insertions(+), 21 deletions(-) diff --git a/docs/docs/Support/troubleshooting.mdx b/docs/docs/Support/troubleshooting.mdx index 132d5bdeefa1..f33cce829e71 100644 --- a/docs/docs/Support/troubleshooting.mdx +++ b/docs/docs/Support/troubleshooting.mdx @@ -97,9 +97,9 @@ To resolve this issue, install `protoc` using `brew install protobuf`. For more information, including alternative installation methods, see the [Protocol buffers installation documentation](https://protobuf.dev/installation/). -### Langflow Installation Error: langflow-install-error +### Langflow installation failed -Langflow Desktop installed Langflow OSS but couldn't verify the installation. You might see error messages like `Langflow Installation Error: langflow-install-error`. +Langflow Desktop installed Langflow OSS but couldn't verify the installation. You might see an error dialog with the title `Langflow Installation Failed` and the message `Langflow installation failed. Please check your internet connection and try again. If the problem persists, restart the application.` To resolve this error, clear Langflow Desktop's Python virtual environment: @@ -110,9 +110,9 @@ To resolve this error, clear Langflow Desktop's Python virtual environment: If the issue persists, ensure you have installed Python version 3.10 or later, and it is accessible by your Langflow installation. If the Python version is correct, try reinstalling Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). -### Langflow Health Check Error: Timeout after 80 attempts +### Langflow startup failed -Langflow Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You might see an error message like `Langflow Health Check Error: Timeout after 80 attempts - Langflow did not become ready`. +Langflow Desktop installed Langflow OSS but the OSS backend isn't responding to health checks. You might see an error dialog with the title `Langflow Startup Failed` and the message `Langflow failed to start properly. Please restart the application and try again.` To resolve this error, do the following: @@ -123,12 +123,7 @@ To resolve this error, do the following: ### Failed to install uv or unable to find uv -The following error messages mean that Langflow Desktop can't locate the `uv` executable on your system, even if it is installed: - -* `Failed to install uv: Unable to find uv executable` -* `Unable to find uv executable for Python virtual environment setup` -* `UV Installation Error: UV installation failed - binary not found after installation` -* `Python Environment Error: UV binary not found at` +Langflow Desktop can't locate or install the `uv` executable. You might see an error dialog with the title `UV Installation Failed` and the message `UV installation failed. Please check your internet connection and try again. If the problem persists, restart the application.` To resolve this error, do the following: @@ -169,9 +164,9 @@ To resolve this error, do the following: 3. Restart Langflow Desktop. -### Python Environment Error: Creation failed +### Python environment failed -Langflow Desktop failed to create the Python virtual environment required for Langflow OSS. You might see error messages like `Python Environment Error: Creation failed:` followed by error details, `Python Environment Error: error_dns`, or other `Python Environment Error:` messages. +Langflow Desktop failed to create the Python virtual environment required for Langflow OSS. You might see an error dialog with the title `Python Environment Failed` and the message `Python environment setup failed. Please ensure you have sufficient disk space and try again.` To resolve this error, do the following: @@ -185,15 +180,15 @@ To resolve this error, do the following: If the issue persists, ensure Python version 3.10 or later is installed and accessible, or reinstall Langflow Desktop from [langflow.org/desktop](https://langflow.org/desktop). -### Python Environment Error: Python check failed +### Python environment failed: Python check failed -Langflow Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You might see error messages like `Python Environment Error: Python check failed:` followed by error details, or other `Python Environment Error:` messages. +Langflow Desktop created the Python virtual environment but couldn't verify that Python is working correctly. You might see an error dialog with the title `Python Environment Failed` and a message about Python verification. -To resolve this error, see [Python Environment Error: Creation failed](#python-environment-error-creation-failed). +To resolve this error, see [Python environment failed](#python-environment-failed). -### Langflow Installation Error: error_xcode +### Xcode Command Line Tools required -Langflow Desktop requires [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) to install Langflow OSS on macOS. You might see error messages like `Langflow Installation Error: error_xcode` or a detailed message with the title `Xcode Command Line Tools required!`. +Langflow Desktop requires [Xcode Command Line Tools](https://developer.apple.com/xcode/resources/) to install Langflow OSS on macOS. You might see an error dialog with the title `Xcode Command Line Tools required!` and instructions to run `xcode-select --install`. To resolve this error, do the following: @@ -201,14 +196,14 @@ To resolve this error, do the following: 2. Launch Xcode at least once. Xcode performs additional setup on first startup that other tools such as Git, VS Code, and Langflow Desktop depend on. 3. Restart Langflow Desktop. -### Langflow Installation Error: error_cpp +### C++ build tools required Microsoft Windows installations of Langflow Desktop require a C++ compiler that might not be present on your system. -If you receive a `Langflow Installation Error: error_cpp` error or a detailed message with the title `C++ Build Tools required!`, follow the on-screen prompt to install Microsoft C++ Build Tools, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). +You might see an error dialog with the title `C++ Build Tools required!` with instructions to install Microsoft C++ Build Tools. Follow the on-screen prompt, or install [Microsoft Visual Studio](https://visualstudio.microsoft.com/downloads/). -### UV Installation Error: uv-manual-install-required +### Manual UV installation required -Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You might see error messages like `UV Installation Error: uv-manual-install-required` or a detailed manual installation message. +Langflow Desktop tried multiple methods to automatically install `uv` but all attempts failed. Desktop requires `uv` to manage Python packages and virtual environments. You might see an error dialog with the title `Manual UV Installation Required` and instructions to install `uv` manually. To resolve this error, do the following: