← プロジェクト一覧に戻る

smolagents

エージェントがJSONではなくPythonコードを書いて行動する、意図的に小さいライブラリ

公式Apache-2.0
スター
30.1k
フォーク
3.2k
オープンIssue
1k
最終コミット
2026年10月29日

smolagentsとは

中心にあるのはCodeAgentで、モデルは構造化されたツール呼び出しを返す代わりに短いPythonコードを書き、ツールを直接呼びます。呼び出しを繰り返しや条件分岐の中に入れる操作は、フレームワークの機能ではなくPython自体から得られます。エージェントのループ全体がおよそ1000行という小ささは利点であると同時に上限でもあり、永続的な状態、ワークフローの記述、保存機構は自分で組むことになります。従来のJSON形式が合う場面向けにToolCallingAgentも同梱されています。

smolagentsで何ができますか?

  • 4行で動くエージェント — toolkit付きでpip installした後は、CodeAgentにモデルを渡してrunを呼ぶだけで完結したプログラムになります。事前に用意すべきプロジェクト構成、設定ファイル、グラフ定義はありません。
  • JSONではなくPythonを書かせる — CodeAgentはモデルに、ツールを呼び出す実行可能なPythonコードを書かせます。繰り返しの中でのツール呼び出しや、結果を次の呼び出しへ直接渡す処理など、通常ならフレームワーク側の機能が要る組み合わせが、普通のコードとして書かれます。
  • そのコードを安全な場所で動かす — モデルの出力を実行する設計のため、自分のインタープリタではなくDockerや、E2B・Modal・Blaxelといった外部サンドボックス上で実行する構成に対応しています。
  • 既にあるツールをそのまま持ち込む — 任意のMCPサーバーからツール群を読み込めるほか、既存のLangChainツールを包んで使うことも、Hugging Face Spaceをそのままツールとして扱うこともできます。
  • モデルは差し替えるだけ — ホスト型の推論プロバイダ、LiteLLM経由のOpenAIやAnthropic、Transformersやollamaで動かすローカルモデルのいずれも、モデルオブジェクトの入れ替えだけで選べます。その上のエージェント側のコードは変わりません。

smolagentsを選ぶ前に

  • モデルが書いたPythonを実行することが選択肢ではなく設計そのものであり、既定のローカル実行は隔離になりません。実データに触れる前にDockerや外部サンドボックスへ移すよう案内されています。
  • 小ささは意図的な上限でもあります。永続的な状態、ワークフローの記述、保存機構は用意されていないため、長時間動かすエージェントや途中再開はその層を自作することになります。

スター推移

8月21日〜10月30日 · +1.2k

28.9k30.1k

よくある質問

smolagentsは商用利用できますか?

smolagentsはApache-2.0ライセンスで公開されています。OSI承認のオープンソースライセンスで、商用利用が認められています。

smolagentsはどの形で使えますか?

smolagentsはセルフホスト・ローカル実行の形で利用できます。

smolagents
AIに聞く
GitHub