Install Langflow

import Tabs from '@theme/Tabs'; import TabItem from '@theme/TabItem'; import Cards from "@site/src/components/Cards"; import Card from "@site/src/components/Card"; import Icon from "@site/src/components/icon";

Langflow can be installed in multiple ways. Choose an option below to jump to the steps.

Install and run Langflow Desktop {#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 and Voice Mode.

Langflow Desktop requires macOS 13 or later.

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.

:::warning
If you are upgrading Langflow Desktop on Windows, **don't** use the in-app update feature to upgrade to Langflow version 1.6.0.
For more information, see [Known issues for 1.6.0](/release-notes#windows-desktop-update-issue).
:::

1. Navigate to Langflow Desktop.

2. Click Download Langflow, enter your contact information, and then click Download.

3. Open the File Explorer, and then navigate to Downloads.

4. Double-click the downloaded .msi file, and then use the install wizard to install Langflow Desktop.

   :::tip 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. :::

5. 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 {#install-and-run-langflow-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:

   bashCopy

   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 {#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
   • Browser:
     • Google Chrome is recommended but not required

2. Create a virtual environment with uv.

   <details> <summary>Need help with virtual environments?</summary>

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

   Copy

    <Tabs>
    <TabItem value="linux-macos" label="Linux or macOS" default>
   
    1. Navigate to where you want your virtual environment to be created, and then create it with `uv`:
   
        ```shell
        uv venv VENV_NAME
        ```
   
        Replace `VENV_NAME` with a name for your virtual environment.
   
    2. Start the virtual environment:
   
        ```shell
        source VENV_NAME/bin/activate
        ```
   
        Your shell's prompt changes to display that you're currently working in a virtual environment:
   
        ```text
        (VENV_NAME) ➜  langflow git:(main) ✗
        ```
   
    3. 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.
        To avoid conflicts with other projects, it's a good idea to deactivate your virtual environment when you're done working in it.
   
        To delete the virtual environment, type `rm -rf VENV_NAME`.
        This completely removes the virtual environment directory and its contents.
   
    </TabItem>
    <TabItem value="Windows" label="Windows">
   
    1. Navigate to where you want your virtual environment to be created, and create it with `uv`.
   
        ```shell
        uv venv VENV_NAME
        ```
   
        Replace `VENV_NAME` with a name for your virtual environment.
   
    2. Start the virtual environment:
   
        ```shell
        VENV_NAME\Scripts\activate
        ```
   
        Your shell's prompt changes to display that you're currently working in a virtual environment:
   
        ```text
        (VENV_NAME) PS C:/users/username/langflow-dir>
        ```
   
    3. 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.
        To avoid conflicts with other projects, it's a good idea to deactivate your virtual environment when you're done working in it.
   
        To delete the virtual environment, type `Remove-Item VENV_NAME`.
        This completely removes the virtual environment directory and its contents.
   
    </TabItem>
    </Tabs>
   

   </details>

3. In your virtual environment, install Langflow:

   bashCopy

   uv pip install langflow
   

4. Start Langflow:

   bashCopy

   uv run langflow run
   

   It can take a few minutes for Langflow to start.

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

6. Create your first flow with the Quickstart.

Manage the Langflow OSS version

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.

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

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

Next steps

• Quickstart: Build and run your first flow in minutes.
• Build flows: Learn about building flows.
• Troubleshoot Langflow: Get help with common Langflow install and startup issues.