简报

开源项目30,200Apache-2.0

smolagents

生成
2026-11-07 13:16
首次公开
2026-11-07 13:19
本版公开
2026-11-07 13:19 · v1
来源
开源技术雷达

访问项目仓库

自动排版

把「agent 的动作」直接写成可执行代码而不是 JSON 工具调用:模型生成 Python 片段,由框架执行并把结果回灌,从而用更少的步骤完成多步任务。定位是极简库而非平台。

目录 · 11 节
  1. 项目介绍
  2. 主要应用领域
  3. 关键技术
  4. 实用价值
  5. 局限
  6. 开源协议
  7. 推荐理由
  8. 观测
  9. 专业社区口碑
  10. 类似项目推荐
  11. 原始阅读依据

项目介绍

smolagents 是 Hugging Face 维护的极简 agent 库,标语是「让 agent 用代码思考」。与常见的「模型输出 JSON 去调用工具」不同,它让模型直接生成 Python 代码片段作为动作,框架执行代码并回传结果。这种「code-as-action」写法能在一步内组合多次调用、循环与数据处理,减少往返次数,但也把执行风险显性化。仓库含 README、Apache-2.0 LICENSE、docs(huggingface.co/docs/smolagents),1,059 次提交,说明维护活跃。

主要应用领域

需要在一步内组合多次工具调用或数据处理的任务、本地/自托管模型下的轻量 agent、教学演示 code-as-action 范式。

关键技术

Python 库,1,059 commits、3.2k forks,附带 SECURITY.md;核心机制为模型生成 Python 代码片段并由框架执行。文档层分析,未运行代码,未验证沙箱实现。

实用价值

用最少抽象换来高表达力同一段代码即可完成循环、条件与多工具组合,适合做为「agent 内核」而非平台。

局限

代码即动作意味着默认需要执行模型生成的代码,沙箱与权限隔离需自行加固;仓库有 418 open issues,稳定性需评估;未读源码,未复现任何任务。

开源协议

Apache-2.0

仓库标注 Apache-2.0 license,并有 SECURITY.md(安全策略文件)——这在同类框架中不常见,说明作者明确意识到代码执行带来的风险面。Apache-2.0 允许商用与修改,需保留声明与标注修改,不含商标授权;依赖的模型与推理服务另有各自条款。

协议解读供选型参考,不构成法律意见。

推荐理由

适合需要在单步内完成复杂数据处理的 agent 场景,以及想理解 code-as-action 范式的团队;生产使用必须自建执行沙箱。

观测

Star30200;观测时间:2026-11-07T05:16:10.000Z

暂无可比增长基线

开源代码

专业社区口碑

已核对社区来源

HN 相关提交多为官方博客转载,热度集中在发布期,后续讨论稀少

未阅读评论正文;样本量不足以支撑口碑结论

正面反馈

Hugging Face 官方博客发布 smolagents 介绍,HN 上对应提交获 11 分、2 条评论,属官方渠道主导的传播

条件与权衡

另有第三方以 smolagents 复刻 Claude Code(smolcc)并提交 HN,仅 2 分 0 评论,说明二次生态存在但讨论稀薄

类似项目推荐

模型知识参考,未在线核验;名称、维护状态和许可证需另行核实。

AgentScope

同用「代码即动作」,但一个做重、一个做薄

AgentScope 提供完整多智能体运行时与语音;smolagents 只有最小循环

pydantic-ai

解决同一个问题(如何让模型可靠地做事)的两条不同路线

pydantic-ai 用类型化工具调用;smolagents 直接执行代码

原始阅读依据

  1. 1GitHub - huggingface/smolagents: a barebones library for agents that think in code
  2. 2HN Algolia 检索:smolagents