Skip to main content

Install Langflow

Langflow can be installed in multiple ways:

Install and run Langflow Desktop​

Langflow Desktop is a desktop version of Langflow that includes all the features of open source Langflow, with an additional version management feature for managing your Langflow version. Langflow Desktop is currently available for macOS.

  1. Navigate to Langflow Desktop.
  2. Click Download Langflow, enter your contact information, and then click Download.
  3. Mount and install the Langflow application.
  4. When the installation completes, open the Langflow application.

After confirming that Langflow is running, create your first flow with the Quickstart.

Manage your version of Langflow Desktop​

When a new version of Langflow is available, Langflow Desktop displays an upgrade message.

To manage your version of Langflow Desktop, follow these steps:

  1. In Langflow Desktop, click your profile image, and then select Version Management. The Version Management pane lists your active Langflow version first, followed by other available versions. The latest version is always highlighted.
  2. To change your Langflow version, select another version. A confirmation pane containing the selected version's changelog appears.
  3. To apply the change, click Confirm. Langflow desktop restarts to install and activate the new version.

Install and run Langflow with Docker​

You can use the Langflow Docker image to run Langflow in an isolated environment. Running applications in Docker containers ensures consistent behavior across different systems and eliminates dependency conflicts.

  1. Install and start Docker.
  2. Pull the latest Langflow Docker image and start it:

_10
docker run -p 7860:7860 langflowai/langflow:latest

  1. To access Langflow, navigate to http://localhost:7860/.

For more information, see Deploy Langflow on Docker.

Install and run the Langflow OSS Python package​

To install and run Langflow OSS, you need the following:

  • Python 3.10 to 3.13 for macOS/Linux, and Python 3.10 to 3.12 for Windows
  • uv
  • At minimum, a dual-core CPU and 2 GB RAM, but a multi-core CPU and at least 4 GB RAM are recommended
  1. Create a virtual environment with uv.
Need help with virtual environments?

Virtual environments ensure Langflow is installed in an isolated, fresh environment. To create a new virtual environment, do the following.

  1. Navigate to where you want your virtual environment to be created, and create it with uv. Replace VENV_NAME with your preferred name for your virtual environment.

_10
uv venv VENV_NAME

  1. Start the virtual environment.

_10
source VENV_NAME/bin/activate

Your shell's prompt changes to display that you're currently working in a virtual environment.


_10
(VENV_NAME) ➜ langflow git:(main) ✗

  1. To deactivate the virtual environment and return to your regular shell, type deactivate. When activated, the virtual environment temporarily modifies your PATH variable to prioritize packages installed within the virtual environment, so always deactivate it when you're done to avoid conflicts with other projects. To delete the virtual environment, type rm -rf VENV_NAME.

  1. To install Langflow, run the following command.


    _10
    uv pip install langflow

  2. After installation, start Langflow:


    _10
    uv run langflow run

  3. To confirm that a local Langflow instance is running, navigate to the default Langflow URL http://127.0.0.1:7860. It can take a few minutes for Langflow to start.

After confirming that Langflow is running, create your first flow with the Quickstart.

Install Langflow from source​

To install Langflow from source, see Install Langflow from source.

Manage Langflow OSS versions​

important

The Langflow team recommends installing new Langflow versions in a new virtual environment before upgrading your primary installation.

This allows you to import flows from your existing installation and test them in the new version without disrupting your existing installation. In the event of breaking changes or bugs, your existing installation is preserved in a stable state.

To manage your Langflow OSS version, use the following commands:

  • Upgrade Langflow to the latest version: uv pip install langflow -U
  • Install a specific version of the Langflow package by adding the required version to the command, such as: uv pip install langflow==1.3.2
  • Reinstall Langflow and all of its dependencies: uv pip install langflow --force-reinstall

Manage Langflow OSS dependencies​

Langflow OSS provides optional dependency groups and support for custom dependencies to extend Langflow functionality. For more information, see Install custom dependencies.

Troubleshoot Langflow installation and startup issues​

If you encounter an issue when installing or running Langflow, see Troubleshoot Langflow.

Next steps​

After installing Langflow, build and run a flow with the quickstart.

Search