Skip to main content

安裝自訂依賴項

AgentBuilder 提供選用的依賴項群組和自訂依賴項支援,以擴展 AgentBuilder 功能。本指南涵蓋如何為不同的 AgentBuilder 安裝添加依賴項,包括 AgentBuilder Desktop 和 AgentBuilder OSS。

AgentBuilder 程式碼庫使用兩個 pyproject.toml 檔案來管理依賴項,一個用於 base,一個用於 main

  • main 套件由根層級的 pyproject.toml 管理,它包含最終使用者功能和主要應用程式程式碼,例如 Langchain 和 OpenAI。
  • base 套件由 src/backend/base/pyproject.toml 管理,它包含核心基礎設施,例如 FastAPI 網路框架。

在 AgentBuilder Desktop 中安裝自訂依賴項

要在 AgentBuilder Desktop 中添加依賴項,請將套件項目添加到應用程式的 requirements.txt 檔案中:

  • 在 macOS 上,檔案位於 /Users/USER/.langflow/data/requirements.txt
  • 在 Windows 上,檔案位於 C:\Users\USER\AppData\Roaming\com.AgentBuilder\data\requirements.txt

DEPENDENCY==VERSION 格式將每個依賴項添加到 requirements.txt 中的單獨行,例如 matplotlib==3.10.0

重新啟動 AgentBuilder Desktop 以安裝依賴項。

如果您需要變更或解除安裝自訂依賴項,請編輯 requirements.txt 檔案,然後重新啟動 AgentBuilder Desktop。

在 AgentBuilder OSS 中安裝自訂依賴項

要在您的 AgentBuilder 環境中安裝自己的自訂依賴項,請使用您的套件管理器添加它們。

如果您在複製的 AgentBuilder 儲存庫中工作,請使用 uv add 添加依賴項,因為已經有 pyproject.toml 檔案供 uv 參考:


_10
uv add DEPENDENCY

安裝選用的依賴項群組

AgentBuilder OSS 提供選用的依賴項群組來擴展其功能。

這些依賴項列在 pyproject.toml 檔案的 [project.optional-dependencies] 下。

使用 pip 的 [extras] 語法安裝依賴項群組。例如,要安裝具有 postgresql 依賴項群組的 AgentBuilder,請輸入以下命令:


_10
uv pip install "langflow[postgresql]"

要安裝多個 extras,請使用逗號分隔每個依賴項群組:


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

使用虛擬環境測試自訂依賴項

在本地測試時,使用虛擬環境來隔離您的依賴項並防止與其他 Python 專案發生衝突。

例如,如果您想在 AgentBuilder 中試驗 matplotlib


_10
# 建立並啟用虛擬環境
_10
uv venv YOUR_LANGFLOW_VENV
_10
source YOUR_LANGFLOW_VENV/bin/activate
_10
_10
# 安裝 langflow 和您的額外依賴項
_10
uv pip install langflow matplotlib

如果您在複製的 AgentBuilder 儲存庫中工作,請使用 uv add 添加依賴項以參考現有的 pyproject.toml 檔案:


_10
uv add matplotlib

uv add 命令會自動更新適當位置的 uv.lock 檔案。

添加依賴項到 AgentBuilder 程式碼庫

為 AgentBuilder 程式碼庫做出貢獻時,您可能需要添加依賴項到 AgentBuilder。

AgentBuilder 使用具有兩個套件的 workspace,每個套件具有不同類型的依賴項。

要添加依賴項到 main 套件,請從專案根目錄執行 uv add DEPENDENCY。 例如:


_10
uv add matplotlib

依賴項可以作為一般依賴項添加到 main 套件的 [project.dependencies],或作為選用依賴項添加到 [project.optional-dependencies]

要添加依賴項到 base 套件,請導航到 src/backend/base 並執行:


_10
cd src/backend/base && uv add DEPENDENCY

要添加用於測試、linting 或除錯的開發依賴項,請導航到 src/backend/base 並執行:


_10
cd src/backend/base && uv add --group dev DEPENDENCY

依賴項可以作為一般依賴項添加到 base 套件的 [project.dependencies],作為開發依賴項添加到 [dependency-groups.dev],或作為選用依賴項添加到 [project.optional-dependencies]

您可以選擇使用 make add 而不是 uv add


_10
# 等同於:uv add matplotlib
_10
make add main="matplotlib"
_10
_10
# 等同於:cd src/backend/base && uv add --group dev matplotlib
_10
make add devel="matplotlib"
_10
_10
# 等同於:cd src/backend/base && uv add matplotlib
_10
make add base="matplotlib"

或者,您可以手動將這些依賴項添加到適當的 pyproject.toml 檔案中:


_10
[project]
_10
dependencies = [
_10
"matplotlib>=3.8.0"
_10
]

或作為 main 套件中的選用依賴項:


_10
[project.optional-dependencies]
_10
plotting = [
_10
"matplotlib>=3.8.0",
_10
]

或作為 base 套件中的開發依賴項:


_10
[dependency-groups]
_10
dev = [
_10
"matplotlib>=3.8.0",
_10
]

另請參閱

Search