From e53f500ccc451355469529cffdaed95f1e7346a0 Mon Sep 17 00:00:00 2001 From: Mendon Kissling <59585235+mendonk@users.noreply.github.com> Date: Thu, 8 May 2025 10:10:11 -0400 Subject: [PATCH] docs: add troubleshooting steps for installation failures on Linux (#7945) * docs: add troubleshooting steps for installation failures on Linux * Update docs/docs/Get-Started/get-started-installation.md --------- Co-authored-by: Madhavan --- .../Get-Started/get-started-installation.md | 24 +++++++++++++++++++ 1 file changed, 24 insertions(+) diff --git a/docs/docs/Get-Started/get-started-installation.md b/docs/docs/Get-Started/get-started-installation.md index 5c580b6e5..6c2c3baf6 100644 --- a/docs/docs/Get-Started/get-started-installation.md +++ b/docs/docs/Get-Started/get-started-installation.md @@ -239,6 +239,30 @@ To run Langflow with uv: uv run langflow run ``` +#### Failed to build required package + +When you try to install Langflow on Linux, installation fails because of outdated or missing packages. + +```bash +Resolved 455 packages in 18.92s + × Failed to build `webrtcvad==2.0.10` + ├─▶ The build backend returned an error + ╰─▶ Call to `setuptools.build_meta:__legacy__.build_wheel` failed (exit status: 1) +``` + +1. Install the required build dependencies. + +```bash +sudo apt-get update +sudo apt-get install build-essential python3-dev +``` + +2. If upgrading your packages doesn't fix the issue, install `gcc` separately. + +```bash +sudo apt-get install gcc +``` + ## Install and run Langflow Desktop :::important