huggingface/smolagents

これは何？

主な機能

• 01CodeAgentはアクションをPythonコードで記述し、ツールを関数呼び出しとして実行します。
• 02ローカルのtransformersモデルやOllamaモデル、Hugging Faceのプロバイダー、OpenAI互換API、LiteLLMに対応しています。
• 03生成コードをE2B、Modal、Blaxel、Dockerなどのサンドボックスで実行できます。
• 04MCPサーバー、LangChain、Hugging Face Spacesからツールを取り込めます。
• 05Hugging Face Hubを通じてエージェントやツールを共有できます。
• 06smolagentとwebagentのCLIを備えています。

ユースケース

• 1回の実行で複数のWebツールやAPIツールを呼び出すエージェントのプロトタイピング。
• 複数ステップの推論が必要な、調査・ブラウジングアシスタントの構築。
• エージェント型ワークフローでのオープンソースモデルの実験。
• コードベースのエージェントとJSON形式のツール呼び出しを使うエージェントの違いを教えたり、学んだりすること。

クイックスタート

1. 1

   デフォルトのツールキットでパッケージをインストールする

   pip install "smolagents[toolkit]"
2. 2

   ツールとモデルを指定してCodeAgentを定義し、実行する

使う前に知っておきたいこと

• !エージェントのコードを安全に実行するには、E2B、Blaxel、Modal、Dockerなどの外部サンドボックスが必要です。組み込みのLocalPythonExecutorはセキュリティ境界ではありません。
• !デフォルトのデモモデルはHugging Faceでホストされているため、通常はプロバイダーのアカウントまたはAPIキーが必要です。

トピック

よくある質問

smolagents とは？

Pythonコードでアクションを記述・実行するAIエージェントを構築するための、軽量なPythonライブラリ。 smolagentsは、LLMを活用したエージェントを構築するための軽量なPythonライブラリです。中核となるCodeAgentは、各アクションをPythonのスニペットとして記述するため、ツール呼び出しは通常の関数呼び出しになり、1つのステップで複数のツールを連携させられます。エージェントのロジックは意図的にコンパクトに保たれており、主要なagentsモジュールは1,000行未満です。そのため、開発者はソースを直接読んで変更できます。

smolagents は無料で使えますか？ライセンスは？

smolagents は Apache-2.0 ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。

smolagents は今もメンテナンスされていますか？

活発にメンテナンス中。smolagents の最終コミットは 2026年10月6日 です。

smolagents は何に使えますか？

1回の実行で複数のWebツールやAPIツールを呼び出すエージェントのプロトタイピング。 複数ステップの推論が必要な、調査・ブラウジングアシスタントの構築。 エージェント型ワークフローでのオープンソースモデルの実験。 コードベースのエージェントとJSON形式のツール呼び出しを使うエージェントの違いを教えたり、学んだりすること。

smolagents のインストール方法は？

デフォルトのツールキットでパッケージをインストールする: pip install "smolagents[toolkit]" ツールとモデルを指定してCodeAgentを定義し、実行する

smolagents はどこで入手できますか？

ソースコードとインストール手順は GitHub にあります：https://github.com/huggingface/smolagents