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 后，你可以：