安装 Langflow

Langflow 有多种安装方式。选择下方的一个选项以跳转至对应的步骤。

Langflow 桌面版（推荐）

包含依赖管理和简单升级功能的独立应用。

Docker

在隔离的容器中运行 Langflow。

Python 包

完全掌控环境、依赖项和版本控制。

从源码安装

为 Langflow 做贡献或基于本地克隆进行工作。

安装并运行 Langflow 桌面版

Langflow 桌面版是 Langflow 的桌面应用程序版本，它简化了依赖项管理和升级过程。然而，桌面版并不支持某些功能，例如共享操场（Shareable Playground）和语音模式（Voice Mode）。

macOS

Langflow 桌面版需要 macOS 13 或更高版本。

1. 访问 Langflow 桌面版页面。
2. 点击下载 Langflow，输入您的联系信息，然后点击下载。
3. 挂载并安装 Langflow 应用程序。
4. 安装完成后，打开 Langflow 应用程序，然后通过快速入门创建您的第一个工作流。

Windows

警告

如果您正在 Windows 上升级 Langflow 桌面版，请不要使用应用内更新功能来升级至 1.6.0 版本。更多信息，请参阅1.6.0 版本已知问题。

1. 访问 Langflow 桌面版页面。

2. 点击下载 Langflow，输入您的联系信息，然后点击下载。

3. 打开文件资源管理器，然后导航到下载目录。

4. 双击下载的 .msi 文件，按照安装向导的提示安装 Langflow 桌面版。

   提示

   Windows 版 Langflow 桌面版需要系统中可能不存在的 C++ 编译器。如果您收到 C++ Build Tools Required! 错误，请根据屏幕提示安装 Microsoft C++ Build Tools，或安装 Microsoft Visual Studio。

5. 安装完成后，打开 Langflow 应用程序，然后通过快速入门创建您的第一个工作流。

有关升级信息，请参阅发行说明。

要在 Langflow 桌面版中管理依赖项，请参阅在 Langflow 桌面版中安装自定义依赖项。

使用 Docker 安装并运行 Langflow

您可以使用 Langflow Docker 镜像来启动 Langflow 容器。更多信息，请参阅在 Docker 上部署 Langflow。

1. 安装并启动 Docker。

2. 拉取最新的 Langflow Docker 镜像并启动它

   
   

   _10

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

   
   

3. 要访问 Langflow，请访问 https://:7860/。

4. 通过快速入门创建您的第一个工作流。

安装并运行 Langflow 开源 Python 包

1. 确保您具备所需的依赖项和基础设施：

   • Python
     • macOS 和 Linux：版本 3.10 到 3.13
     • Windows：版本 3.10 到 3.12
   • uv
   • 足够的基础设施
     • 最低要求：双核 CPU 和 2 GB 内存
     • 推荐要求：多核 CPU 和至少 4 GB 内存
   • 浏览器
     • 推荐使用 Google Chrome，但非必需

2. 使用 uv 创建一个虚拟环境。

   需要有关虚拟环境的帮助？

   虚拟环境可确保 Langflow 安装在隔离、干净的环境中。要创建新的虚拟环境，请执行以下操作。

   Linux 或 macOS

   1. 导航到您想要创建虚拟环境的位置，然后使用 uv 创建它：

      
      

      _10

      uv venv VENV_NAME

      
      

      将 VENV_NAME 替换为您虚拟环境的名称。

   2. 启动虚拟环境：

      
      

      _10

      source VENV_NAME/bin/activate

      
      

      您的 shell 提示符将会改变，以显示您当前正在虚拟环境中工作：

      
      

      _10

      (VENV_NAME) ➜ langflow git:(main) ✗

      
      

   3. 要停用虚拟环境并返回常规 shell，请输入 deactivate。

      激活后，虚拟环境会暂时修改您的 PATH 变量，从而优先使用虚拟环境中安装的包。为了避免与其他项目冲突，建议在完成工作后停用虚拟环境。

      要删除虚拟环境，请输入 rm -rf VENV_NAME。这将完全移除虚拟环境目录及其内容。

   Windows

   1. 导航到您想要创建虚拟环境的位置，并使用 uv 创建它。

      
      

      _10

      uv venv VENV_NAME

      
      

      将 VENV_NAME 替换为您虚拟环境的名称。

   2. 启动虚拟环境：

      
      

      _10

      VENV_NAME\Scripts\activate

      
      

      您的 shell 提示符将会改变，以显示您当前正在虚拟环境中工作：

      
      

      _10

      (VENV_NAME) PS C:/users/username/langflow-dir>

      
      

   3. 要停用虚拟环境并返回常规 shell，请输入 deactivate。

      激活后，虚拟环境会暂时修改您的 PATH 变量，从而优先使用虚拟环境中安装的包。为了避免与其他项目冲突，建议在完成工作后停用虚拟环境。

      要删除虚拟环境，请输入 Remove-Item VENV_NAME。这将完全移除虚拟环境目录及其内容。

3. 在您的虚拟环境中，安装 Langflow：

   
   

   _10

   uv pip install langflow

   
   

   要安装特定版本的 Langflow 包，请在命令中添加所需的版本，例如 uv pip install langflow==1.4.22。

   重新安装或升级 Langflow

   要重新安装 Langflow 及其所有依赖项，请运行 uv pip install langflow --force-reinstall。

   要将 Langflow 升级到最新版本，请运行 uv pip install langflow -U。不过，Langflow 团队建议在升级之前备份您现有的安装。更多信息，请参阅准备升级。

4. 启动 Langflow：

   
   

   _10

   uv run langflow run

   
   

   Langflow 启动可能需要几分钟时间。

5. 要确认本地 Langflow 实例是否正在运行，请访问默认的 Langflow URL http://127.0.0.1:7860。

6. 通过快速入门创建您的第一个工作流。

有关升级信息，请参阅发行说明。

有关可选依赖组以及通过安装自定义依赖项扩展 Langflow OSS 功能的信息，请参阅安装自定义依赖项。

下一步

• 快速入门：在几分钟内构建并运行您的第一个工作流。
• 构建工作流：了解有关构建工作流的知识。
• 排查 Langflow 问题：获取有关常见安装和启动问题的帮助。