OSS探訪
GitHubでログイン
GitHubで見るプロジェクトサイト

コードでツールを呼び出すAIエージェントを、少ない抽象化で組み立てるPythonライブラリ

OSS規模スコア 288.5OSS健全度 88更新ペース 4 Commit/30日
スコアの見方

OSS規模スコアはStars・Watchers・Forks・Contributorsを対数圧縮して重み付けした現在の規模指標（上限なし）です。発掘スコアは現在のOSS規模スコアから発掘時点のOSS規模スコアを引いた値、更新ペースは直近30日Commit数、成長モメンタムは直近の観測期間におけるOSS規模スコア差、OSS健全度は取得できた更新状況・Community Health・Releaseの0〜100評価です。

Stars
29,667
主要言語
Python
ライセンス
Apache-2.0
リポジトリ最終更新
2026/09/30
ページ内ナビ

概要

smolagentsは、大規模言語モデルがツールを呼び出しながら課題を解くAIエージェントをPythonで構築するためのライブラリです。行動をPythonコードとして生成するCodeAgentと、JSONやテキスト形式でツールを選ぶToolCallingAgentを備えています。モデル、ツール、実行環境を用途に応じて差し替えられます。

特徴と向いている用途

公式資料に基づく紹介・実機未検証 · 内容確認日：

主な特徴

処理手順をPythonコードとして生成し、複数のツールをまとめて扱う

CodeAgentはReAct形式の反復処理の中で、ツール呼び出しをPythonコードとして生成します。条件分岐や反復を含む複数操作を一つの行動にまとめられるため、検索・計算・データ処理を組み合わせるエージェントを少ないコードで構成できます。一般的なツール呼び出し形式を使うToolCallingAgentも選択できます。

出典：[2]

モデル、MCP、Hub上のツール、実行環境を用途に合わせて選ぶ

Hugging Face Inference Providers、ローカルのTransformersやOllama、LiteLLM経由の各種サービス、OpenAI互換APIなどをモデルとして利用できます。MCPサーバー、LangChain、Hub Spaceのツールも接続でき、コード実行先にはE2B、Blaxel、Modal、Dockerなどの隔離環境を選べます。

出典：[2]

向いている用途

エージェントの制御ループを理解しながら小さく試したい開発に向く

抽象化の少ない実装を読みながら、独自ツールやモデルを組み込んだエージェントを試したい場合に向きます。複数エージェント構成、画像・音声などの入力、Hubを介した共有まで段階的に広げられるため、試作から仕組みの検証へ進みやすい構成です。

出典：[2]

導入前の確認

生成コードは信頼せず、隔離環境と外部サービスの権限を設計する

CodeAgentが生成するコードは任意の処理を実行し得ます。組み込みのLocalPythonExecutorは安全境界ではなく、信頼できないコードにはE2B、Blaxel、Modal、Dockerなどの隔離環境が必要です。外部モデルやツールへ渡すデータ、APIキーの権限、実行時間と費用も個別に制限してください。Python 3.10以上が必要で、利用するモデルや追加機能によって別の依存関係や認証情報が必要です。

出典：[2][4]

参考にした公式資料

  1. [1]huggingface/smolagents repository metadata(2026-10-04)
  2. [2]smolagents v1.26.0 README(2026-10-04)
  3. [3]smolagents v1.26.0 release(2026-10-04)
  4. [4]smolagents v1.26.0 pyproject.toml(2026-10-04)
  5. [5]smolagents v1.26.0 Apache-2.0 license(2026-10-04)
編集部からの補足

エージェント基盤を選ぶときは、機能数だけでなく制御ループを読んで変更できるかも重要です。smolagentsはその比較がしやすい一方、生成コードの実行先を安全境界として設計することが導入の前提になります。

3ステップで試す

  1. 1

    専用の仮想環境を作成する

    Python 3.10以上を使い、試用する依存関係をプロジェクト内へ分離します。

    python -m venv .venv && source .venv/bin/activate
  2. 2

    標準ツール付きでインストールする

    READMEのQuick demoで案内されているtoolkit extraを、確認済みの安定版へ固定します。

    python -m pip install "smolagents[toolkit]==1.26.0"
  3. 3

    コマンドラインの起動を確認する

    モデルの認証情報を渡したり生成コードを実行したりせず、CLIが利用できることだけを確認します。

    smolagent --help
公式READMEで確認

成長

成長の推移 · 直近30日

29,667 Stars

推移データを蓄積中です。

開発アクティビティ

直近90日・週次

Commit（直近30日）
4
Open PR
523

開発アクティビティを蓄積中です。

Built with

カテゴリとタグ

カテゴリ

タグ

GitHubデータ

GitHubのデータGitHubの詳細データを見る
GitHubで見る
Stars
29,667
Forks
3,042
Watchers
143
Open Issues
349
Contributors
208
所有者種別
Organization
主要言語
Python
ライセンス
Apache-2.0
リポジトリ最終更新
2026/09/30
関連記事を投稿する

このOSSの使い方や活用事例をMarkdownで投稿できます。管理者が承認した後に公開されます。

情報の誤りを報告

掲載内容に誤りや古い情報があればお知らせください。

このページを読んで、次に何をすればよいか分かりましたか？