Agents · 轻量 Agent 框架
smolagents
让模型写代码调用工具的轻量 Agent 框架
smolagents 是 Hugging Face 的轻量 Agent 框架，核心是用少量代码让模型通过写 Python 代码来调用工具。
状态
verified
开源
价格
开源免费
开源 / 许可证以仓库为准
入口
GitHub / Python / 本地运行
本地运行 / 自托管 / SDK 集成
API
可接第三方 API
可接第三方模型
形态
开源 Python 框架
Python
选型结论
适合想用很少代码快速搭出会写代码 Agent 的开发者，也适合原型和教学。框架轻、上手快，可接 Hugging Face、OpenAI、Anthropic 与本地模型。生态和文档相对新，复杂生产编排不如成熟框架，重流程项目需谨慎。
定位
适合
成本口径
核心能力
代码即动作
模型通过写 Python 代码调用工具，把动作直接表达成可执行代码，逻辑更直观。
上手成本低
少量代码即可跑通一个 Agent，适合快速验证想法和课堂演示。
多模型可选
支持 Hugging Face、OpenAI、Anthropic 以及本地模型，切换成本不高。
开源可自托管
代码开源，可在本地运行或自托管部署，也支持以 SDK 方式集成到项目。
典型使用场景
原型快速验证
想法刚成形时，用少量代码跑通一个会写代码的 Agent，先看效果再决定是否扩展。
教学与演示
代码结构简单，便于讲解 Agent 如何生成代码、调用工具并返回结果。
多模型试验
在同一套代码里切换 Hugging Face、OpenAI 或本地模型，比较不同模型的表现。
上手步骤
- 1
准备环境
安装 Python 依赖，从 GitHub 获取仓库，按文档配置模型与密钥。
- 2
接一个模型
选择 Hugging Face、OpenAI 或 Anthropic 接口，也可指向本地运行的模型。
- 3
写一个 Agent
用少量代码定义工具与 Agent，让它通过写 Python 调用工具完成任务。
- 4
本地跑起来
在本地运行或自托管部署，再以 SDK 方式接进自己的项目。
价格与使用方式
价格口径
开源状态
API 状态
使用入口
运行方式
支持平台
常见连接对象
所属生态
优点与局限
值得选的地方
- 少量代码即可跑通一个代码型 Agent
- 可接 Hugging Face、OpenAI 与本地模型
- 开源，可在本地运行或自托管部署
先想清楚的地方
- 生态和文档相对新，可参考资料有限
- 复杂生产编排能力不如成熟框架
适合谁用
更适合
- 想快速搭原型的开发者
- 做 Agent 教学的讲师
- 偏好轻量框架的个人项目
不太适合
- 需要复杂多步编排的团队
- 要求成熟生产工具链的项目
同类对比
4 个同类| 产品 | 形态 | 价格口径 | 开源 | 地区 |
|---|---|---|---|---|
| smolagents Hugging Face · 本页 | 开源 Python 框架 | 开源免费 | 是 | 海外 |
| AgentForge FrostLogic | TypeScript 框架 | 开源免费 | 是 | 海外 |
| OpenHands All Hands AI | 开源 Agent 平台 | 开源免费，云端服务按用量计费 | 是 | 海外 |
| Mastra Mastra | TypeScript Agent Framework | 开源免费 | 是 | 海外 |
| Agno Agno | 开发框架 / 运行时 | 开源免费 | 是 | 海外 |
按分类、形态和接入方式挑出最接近的同类，价格口径以各自详情页为准。
常见问题
4 条smolagents 是什么，适合谁用？
它是 Hugging Face 的轻量 Agent 框架，让模型通过写 Python 代码调用工具。适合想用很少代码搭 Agent 的开发者。
smolagents 支持哪些模型？
可接 Hugging Face、OpenAI、Anthropic 以及本地模型，切换时主要改配置和调用方式。
smolagents 怎么在本地运行？
从 GitHub 获取仓库，安装 Python 依赖并配置模型密钥，即可在本地运行或自托管部署。
smolagents 适合替代成熟框架吗？
它更轻，适合原型和教学；复杂生产编排不如 LangGraph 等成熟框架，重流程项目要慎重。
网站入口
1 个使用提醒
生态和文档相对新，复杂生产编排能力不如成熟框架。