安装 Langflow

Langflow 可以通过三种方式安装

• 作为 Python 包 使用 Langflow OSS
• 作为 独立桌面应用程序 使用 Langflow Desktop
• 作为 云托管服务 使用 DataStax Langflow

安装和运行 Langflow OSS

在安装和运行 Langflow OSS 之前，请确保您具备以下各项。

• Python 3.10 至 3.13
• uv 或 pip
• 使用 uv 或 venv 创建的虚拟环境
• 双核 CPU 和至少 2 GB 内存。更密集的使用需要多核 CPU 和至少 4 GB 内存。

使用 uv（推荐） 或 pip 安装和运行 Langflow OSS。

1. 要安装 Langflow，请使用以下命令之一

uv

_10

uv pip install langflow

pip

_10

pip install langflow

2. 要运行 Langflow，请使用以下命令之一

uv

_10

uv run langflow run

pip

_10

python -m langflow run

3. 要确认本地 Langflow 实例已启动，请访问默认的 Langflow URL：http://127.0.0.1:7860。

确认 Langflow 正在运行后，使用快速入门创建您的第一个流。

管理 Langflow OSS 版本

要将 Langflow 升级到最新版本，请使用以下命令之一

uv

_10

uv pip install langflow -U

pip

_10

pip install langflow -U

要安装 Langflow 包的特定版本，请在命令中添加所需版本。

uv

_10

uv pip install langflow==1.3.2

pip

_10

pip install langflow==1.3.2

要重新安装 Langflow 及其所有依赖项，请在命令中添加 --force-reinstall 标志。

uv

_10

uv pip install langflow --force-reinstall

pip

_10

pip install langflow --force-reinstall

安装 Langflow OSS 的可选依赖项

Langflow OSS 提供了可选的依赖组，用于扩展其功能。

这些依赖项列在 pyproject.toml 文件中，位于 [project.optional-dependencies] 下。

使用 pip 的 [extras] 语法安装依赖组。例如，要安装带有 postgresql 依赖组的 Langflow，请输入以下命令之一

uv

_10

uv pip install "langflow[postgresql]"

pip

_10

pip install "langflow[postgresql]"

要安装多个 extras，请输入以下命令之一

uv

_10

uv pip install "langflow[deploy,local,postgresql]"

pip

_10

pip install "langflow[deploy,local,postgresql]"

要添加您自己的自定义依赖项，请参阅安装自定义依赖项。

停止 Langflow OSS

要停止 Langflow，请在运行它的终端中输入 Ctrl+C。

要停用您的虚拟环境，请输入 deactivate。

常见的 OSS 安装问题

这是您在安装和运行 Langflow 时可能遇到的一些问题列表。

没有 langflow.__main__ 模块

当您尝试使用命令 langflow run 运行 Langflow 时，会遇到以下错误

_10

> No module named 'langflow.__main__'

1. 请改用 uv run langflow run 运行，而不是 langflow run。
2. 如果这不起作用，请使用 uv pip install langflow -U 重新安装最新的 Langflow 版本。
3. 如果这不起作用，请使用 uv pip install langflow --pre -U --force-reinstall 重新安装 Langflow 及其依赖项。

Langflow runTraceback

当您尝试使用命令 langflow run 运行 Langflow 时，会遇到以下错误

_10

> langflow runTraceback (most recent call last): File ".../langflow", line 5, in <module> from langflow.__main__ import mainModuleNotFoundError: No module named 'langflow.__main__'

出现此错误可能有以下两个原因

1. 您使用 pip install langflow 安装了 Langflow，但您的系统中已安装了之前的 Langflow 版本。在这种情况下，您可能正在运行错误的执行文件。要解决此问题，请运行正确的执行文件，即使用 python -m langflow run 代替 langflow run。如果这不起作用，请尝试使用 uv pip install langflow --pre -U 卸载并重新安装 Langflow。
2. 安装过程中可能发生了版本冲突。运行 python -m pip install langflow --pre -U --force-reinstall 重新安装 Langflow 及其依赖项。

运行迁移时出现问题

_10

> Something went wrong running migrations. Please, run 'langflow migration --fix'

通过删除缓存文件夹中的内容来清除缓存。

该文件夹位于

• Linux 或 Windows 上的 WSL2: home/<username>/.cache/langflow/
• MacOS: /Users/<username>/Library/Caches/langflow/

此错误可能在 Langflow 升级期间发生，当新版本无法覆盖 .cache/langflow/ 中的 langflow-pre.db 时。清除缓存会删除此文件，但也会擦除您的设置。

如果您希望保留您的文件，请在清除文件夹之前备份它们。

Langflow 安装在 pip 依赖解析时卡住

使用 pip install langflow 安装 Langflow 会缓慢失败并出现此错误消息

_10

pip is looking at multiple versions of <<library>> to determine which version is compatible with other requirements. This could take a while.

要解决此问题，请改用 uv 而不是 pip 安装 Langflow。

_10

uv pip install langflow

使用 uv 运行 Langflow

_10

uv run langflow run

构建所需包失败

当您尝试在 Linux 上安装 Langflow 时，由于过时或缺失的软件包导致安装失败。

_10

Resolved 455 packages in 18.92s

_10

× Failed to build webrtcvad==2.0.10

_10

├─▶ The build backend returned an error

_10

╰─▶ Call to setuptools.build_meta:__legacy__.build_wheel failed (exit status: 1)

1. 安装所需的构建依赖项。

_10

sudo apt-get update

_10

sudo apt-get install build-essential python3-dev

2. 如果升级软件包不能解决问题，请单独安装 gcc。

_10

sudo apt-get install gcc

安装和运行 Langflow Desktop

重要

Langflow Desktop 处于 Alpha 阶段。开发正在进行中，功能和特性可能会有所变动。

Langflow Desktop 是 Langflow 的桌面版本，包含开源 Langflow 的所有功能，并额外增加了版本管理功能，用于管理您的 Langflow 版本。

重要

Langflow Desktop 仅适用于 macOS。

要安装 Langflow Desktop，请按照以下步骤操作

1. 访问 Langflow Desktop。
2. 输入您的 姓名、电子邮件地址和公司，然后点击 下载。
3. 打开 Finder，然后导航到 Downloads。
4. 双击下载的 *.dmg 文件。
5. 要安装 Langflow Desktop，请将应用程序图标拖放到 Applications 文件夹。
6. 安装完成后，打开 Langflow 应用程序。

应用程序会检查 uv、您的本地环境以及 Langflow 版本，然后启动。

在 Langflow Desktop 中管理您的 Langflow 版本

当有新版本的 Langflow 可用时，Langflow Desktop 会显示升级消息。

要在 Langflow Desktop 中管理您的 Langflow 版本，请按照以下步骤操作

1. 要访问 Langflow Desktop 的 版本管理 面板，请点击您的个人资料图片，然后选择 版本管理。Langflow Desktop 的当前版本将显示，其后列出其他版本选项。最新版本始终会高亮显示。
2. 要更改您的 Langflow 版本，请选择另一个版本。将出现一个包含所选版本更新日志的确认面板。
3. 要更改为所选版本，请点击确认。应用程序将使用新版本重新启动。

DataStax Langflow

DataStax Langflow 是一个托管版本的 Langflow，与 Astra DB 集成。无需安装或设置，几分钟内即可运行。免费注册。