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

smolagents
エージェントがJSONではなくPythonコードを書いて行動する、意図的に小さいライブラリ
公式Apache-2.0
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はセルフホスト・ローカル実行の形で利用できます。