diff --git a/docs/docs/Develop/install-custom-dependencies.md b/docs/docs/Develop/install-custom-dependencies.md index e838108f7..7eaf3caed 100644 --- a/docs/docs/Develop/install-custom-dependencies.md +++ b/docs/docs/Develop/install-custom-dependencies.md @@ -5,7 +5,30 @@ slug: /install-custom-dependencies Langflow provides optional dependency groups and support for custom dependencies to extend Langflow functionality. -## Install optional dependency groups +## Install custom dependencies in Langflow Desktop {#langflow-desktop} + +To add dependencies to Langflow Desktop, add an entry for the package to the application's `requirements.txt` file: + + * On macOS, the file is located at `/Users/USER/.langflow/data/requirements.txt`. + * On Windows, the file is located at `C:\Users\USER\AppData\Roaming\com.Langflow\data\requirements.txt`. + +Add the dependency and version to `requirements.txt` on separate lines in the format `PACKAGE==VERSION`, such as `docling==2.40.0`. + +Restart Langflow Desktop to install the dependencies. + +If you need to change or uninstall custom dependencies. edit the `requirements.txt` file, and then restart Langflow Desktop. + +## Install custom dependencies in Langflow OSS + +To install your own custom dependencies in your Langflow environment, add them with your package manager. + +If you're working within a cloned Langflow repository, add dependencies with `uv add` because there is already a `pyproject.toml` file for uv to reference: + +```bash +uv add langflow DEPENDENCY +``` + +### Install optional dependency groups Langflow OSS provides optional dependency groups that extend its functionality. @@ -23,16 +46,6 @@ To install multiple extras, use commas to separate each dependency group: uv pip install "langflow[deploy,local,postgresql]" ``` -## Install custom dependencies - -To install your own custom dependencies in your Langflow environment, add them with your package manager. - -If you're working within a cloned Langflow repository, add dependencies with `uv add` because there is already a `pyproject.toml` file for uv to reference: - -```bash -uv add langflow DEPENDENCY -``` - ### Use a virtual environment to test custom dependencies When testing locally, use a virtual environment to isolate your dependencies and prevent conflicts with other Python projects. diff --git a/docs/docs/Get-Started/get-started-installation.md b/docs/docs/Get-Started/get-started-installation.md index 4d5aee402..7960d8a5e 100644 --- a/docs/docs/Get-Started/get-started-installation.md +++ b/docs/docs/Get-Started/get-started-installation.md @@ -63,6 +63,10 @@ To manage your version of Langflow Desktop, follow these steps: 3. To apply the change, click **Confirm**. Langflow desktop restarts to install and activate the new version. +### Manage dependencies in Langflow Desktop + +To manage dependencies in Langflow Desktop, see [Install custom dependencies in Langflow Desktop](/install-custom-dependencies#langflow-desktop). + ## Install and run Langflow with Docker {#install-and-run-langflow-docker} You can use the [Langflow Docker image](https://hub.docker.com/r/langflowai/langflow) to run Langflow in an isolated environment. diff --git a/docs/docs/Support/troubleshooting.md b/docs/docs/Support/troubleshooting.md index 8edd45a1e..ed8a57357 100644 --- a/docs/docs/Support/troubleshooting.md +++ b/docs/docs/Support/troubleshooting.md @@ -112,6 +112,12 @@ There are two possible reasons for this error: * **Version conflict during installation**: Some version conflicts might have occurred during the installation process. To resolve this issue, reinstall Langflow and its dependencies by running `python -m pip install langflow --pre -U --force-reinstall`. +### Package is not installed + +In Langflow OSS, you can follow the error message's instructions to install the missing dependency. + +To manage dependencies in Langflow Desktop, see [Install custom dependencies in Langflow Desktop](/install-custom-dependencies#langflow-desktop). + ## Langflow upgrade issues The following issues can occur when upgrading your Langflow version.