smolagents 文件
安裝選項
加入 Hugging Face 社群
並獲得增強的文件體驗
開始使用
安裝選項
smolagents 庫可以使用 pip 安裝。以下是不同的安裝方法和可用選項。
先決條件
虛擬環境
強烈建議在 Python 虛擬環境中安裝 smolagents。虛擬環境將你的專案依賴項與其他 Python 專案和系統 Python 安裝隔離開來，從而防止版本衝突，使包管理更加可靠。
venv
uv
使用 venv
python -m venv .venv
source .venv/bin/activate基本安裝
安裝 smolagents 核心庫：
pip
uv
pip install smolagents
帶附加功能的安裝
smolagents 提供了一些可選的依賴項（附加功能），可以根據你的需求進行安裝。你可以使用以下語法安裝這些附加功能：
pip
uv
pip install "smolagents[extra1,extra2]"工具
這些附加功能包括各種工具和整合：
pip
uv
- toolkit: 安裝一套用於常見任務的預設工具集。
pip install "smolagents[toolkit]" - mcp: 新增對模型上下文協議 (MCP) 的支援，以便與外部工具和服務整合。
pip install "smolagents[mcp]"
模型整合
這些附加功能可實現與各種 AI 模型和框架的整合：
pip
uv
- openai: 新增對 OpenAI API 模型的支援。
pip install "smolagents[openai]" - transformers: 啟用 Hugging Face Transformers 模型。
pip install "smolagents[transformers]" - vllm: 新增 VLLM 支援以實現高效的模型推理。
pip install "smolagents[vllm]" - mlx-lm: 啟用對 MLX-LM 模型的支援。
pip install "smolagents[mlx-lm]" - litellm: 新增 LiteLLM 支援以實現輕量級模型推理。
pip install "smolagents[litellm]" - bedrock: 啟用對 AWS Bedrock 模型的支援。
pip install "smolagents[bedrock]"
多模態能力
用於處理不同型別媒體和輸入的附加功能：
pip
uv
- vision: 新增對影像處理和計算機視覺任務的支援。
pip install "smolagents[vision]" - audio: 啟用音訊處理功能。
pip install "smolagents[audio]"
遠端執行
用於遠端執行程式碼的附加功能：
pip
uv
- docker: 新增在 Docker 容器中執行程式碼的支援。
pip install "smolagents[docker]" - e2b: 啟用 E2B 支援以進行遠端執行。
pip install "smolagents[e2b]"
遙測和使用者介面
用於遙測、監控和使用者介面元件的附加功能：
pip
uv
- telemetry: 新增對監控和追蹤的支援。
pip install "smolagents[telemetry]" - gradio: 新增對互動式 Gradio UI 元件的支援。
pip install "smolagents[gradio]"
完整安裝
要安裝所有可用的附加功能，你可以使用：
pip
uv
pip install "smolagents[all]"驗證安裝
安裝後，你可以透過執行以下命令來驗證 smolagents 是否已正確安裝：
import smolagents
print(smolagents.__version__)後續步驟
成功安裝 smolagents 後，你可以：