Skip to main content

Install Langflow

Langflow can be installed in multiple ways:

  • Langflow Desktop (Recommended): Download and install the standalone desktop application for the least complicated setup experience. This option includes dependency management and facilitated upgrades.

  • Docker: Pull and run the Langflow Docker image to start a Langflow container and run Langflow in isolation.

  • Python package: Install and run the Langflow OSS Python package. This option offers more control over the environment, dependencies, and versioning.

  • Install from source: Use this option if you want to contribute to the Langflow codebase or documentation.

Install and run Langflow Desktop

Langflow Desktop is a desktop version of Langflow that simplifies dependency management and upgrades. However, some features aren't available for Langflow Desktop, such as the Shareable Playground.

  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, and then create your first flow with the Quickstart.

For upgrade information, see the Release notes.

To manage dependencies in Langflow Desktop, see Install custom dependencies in Langflow Desktop.

Install and run Langflow with Docker

You can use the Langflow Docker image to start a Langflow container. For more information, see Deploy Langflow on Docker.

  1. Install and start Docker.

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


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

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

  4. Create your first flow with the Quickstart.

Install and run the Langflow OSS Python package

  1. Make sure you have the required dependencies and infrastructure:

    • Python
      • macOS and Linux: Version 3.10 to 3.13
      • Windows: Version 3.10 to 3.12
    • uv
    • Sufficient infrastructure:
      • Minimum: Dual-core CPU and 2 GB RAM
      • Recommended: Multi-core CPU and at least 4 GB RAM
  2. 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. In your virtual environment, install Langflow:


    _10
    uv pip install langflow

    To install a specific version of the Langflow package by adding the required version to the command, such as uv pip install langflow==1.4.22.

    Reinstall or upgrade Langflow

    To reinstall Langflow and all of its dependencies, run uv pip install langflow --force-reinstall.

    To upgrade Langflow to the latest version, run uv pip install langflow -U. However, the Langflow team recommends taking steps to backup your existing installation before you upgrade Langflow. For more information, see Prepare to upgrade.

  2. Start Langflow:


    _10
    uv run langflow run

    It can take a few minutes for Langflow to start.

  3. To confirm that a local Langflow instance is running, navigate to the default Langflow URL http://127.0.0.1:7860.

  4. Create your first flow with the Quickstart.

For upgrade information, see the Release notes.

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

Next steps

Search