LLMアプリケーションに入出力ガードを追加し、LLMの出力から検証済みの構造化データを生成するPythonフレームワーク。
Eigenwise/atomic-agents
InstructorとPydanticを基盤に、モジュール式でスキーマ駆動のAIエージェントパイプラインを構築する軽量なPythonフレームワーク。
- スター
- 6,319
- フォーク
- 561
- 未解決の Issue
- 12
- 最終コミット
- 8 日前
これは何?
Atomic Agentsは、小さく単一の役割に特化したコンポーネントを組み合わせて、LLMベースのエージェントやパイプラインを構築するためのPythonフレームワークです。各エージェントは、システムプロンプト、入力スキーマ、出力スキーマ、チャット履歴、そして実行時にプロンプトへ動的な情報を注入する任意のコンテキストプロバイダーで定義されます。スキーマにはPydanticモデルを使うため、入出力の検証が行われ、予測可能な結果が得られます。
エージェントの出力スキーマを別のツールの入力スキーマに合わせれば、周囲のコードを書き直すことなく、エージェントやツールを連結したり入れ替えたりできます。制御フローはすべて通常のPythonコードで記述します。Instructorを基盤としているため、OpenAI、Anthropic、Groq、Gemini、Ollamaなど、Instructorが対応するプロバイダーを利用できます。
リポジトリにはAtomic Forgeも含まれており、Web検索、Wikipedia、YouTubeの文字起こし取得、PDF読み込みなどのすぐに使えるツールが揃っています。これらのツールをプロジェクトにコピーするための対話型CLI、Atomic Assemblerも用意されています。サンプルアプリケーションでは、RAGチャット、深層リサーチ、オーケストレーションエージェントを取り上げています。
主な機能
- 01エージェントは、システムプロンプト、Pydanticの入出力スキーマ、チャット履歴で定義します。
- 02コンテキストプロバイダーが、実行時に動的な情報をシステムプロンプトへ注入します。
- 03入出力スキーマを合わせることで、エージェントやツールを連結できます。
- 04OpenAI、Anthropic、Groq、Gemini、Ollamaなど、Instructorが対応するあらゆるプロバイダーを利用できます。
- 05Atomic Forgeには、検索、スクレイピング、PDF読み込みなどに使える既成のツールが揃っています。
- 06各実行はOpenTelemetry spanとして出力されるため、可観測性を確保できます。
ユースケース
- 予測可能なスキーマが重要な、構造化出力型チャットボットや情報抽出パイプラインの構築。
- 再利用可能なツールコンポーネントを使った、RAGエージェントやWeb検索エージェントのプロトタイピング。
- アプリケーションロジックを書き直さずに、LLMプロバイダーや検索バックエンドを切り替える。
- OpenTelemetry互換の任意のバックエンドを使った、LLMアプリケーションへのトレーシング追加。
クイックスタート
- 1
PyPIからフレームワークをインストールします
pip install atomic-agents - 2
OpenAI以外のプロバイダーが必要な場合は、そのプロバイダーのSDKをインストールします(例:Anthropic)
pip install instructor[anthropic] - 3
READMEのQuick Exampleを使ってエージェントを作成し、Pythonで実行します
使う前に知っておきたいこと
- エージェントを実行するには、OpenAI、Groq、Anthropic、GeminiなどのモデルプロバイダーのAPIキーが必要です。
収録されている特集
トピック
よくある質問
- atomic-agents とは?
- InstructorとPydanticを基盤に、モジュール式でスキーマ駆動のAIエージェントパイプラインを構築する軽量なPythonフレームワーク。 Atomic Agentsは、小さく単一の役割に特化したコンポーネントを組み合わせて、LLMベースのエージェントやパイプラインを構築するためのPythonフレームワークです。各エージェントは、システムプロンプト、入力スキーマ、出力スキーマ、チャット履歴、そして実行時にプロンプトへ動的な情報を注入する任意のコンテキストプロバイダーで定義されます。スキーマにはPydanticモデルを使うため、入出力の検証が行われ、予測可能な結果が得られます。
- atomic-agents は無料で使えますか?ライセンスは?
- atomic-agents は MIT ライセンスのオープンソースです。商用製品で使う前にライセンス条件を確認してください。
- atomic-agents は今もメンテナンスされていますか?
- 活発にメンテナンス中。atomic-agents の最終コミットは 2026年10月29日 です。
- atomic-agents は何に使えますか?
- 予測可能なスキーマが重要な、構造化出力型チャットボットや情報抽出パイプラインの構築。 再利用可能なツールコンポーネントを使った、RAGエージェントやWeb検索エージェントのプロトタイピング。 アプリケーションロジックを書き直さずに、LLMプロバイダーや検索バックエンドを切り替える。 OpenTelemetry互換の任意のバックエンドを使った、LLMアプリケーションへのトレーシング追加。
- atomic-agents のインストール方法は?
- PyPIからフレームワークをインストールします: pip install atomic-agents OpenAI以外のプロバイダーが必要な場合は、そのプロバイダーのSDKをインストールします(例:Anthropic): pip install instructor[anthropic] READMEのQuick Exampleを使ってエージェントを作成し、Pythonで実行します
- atomic-agents はどこで入手できますか?
- ソースコードとインストール手順は GitHub にあります:https://github.com/Eigenwise/atomic-agents
概要はプロジェクトの README をもとに AI が生成しています。GitHub の数値は毎日更新されます。
関連プロジェクト
型付きLLM呼び出しを、構造化・テスト可能・自己検証型のAIワークフローに変える生成プログラムを記述するPythonライブラリ。
エージェント、フロー、オプティマイザーを備えた、型付きの構造化LLMプログラムを構築するTypeScriptファーストのDSPy風フレームワーク。Python、Java、C++、Go、Rustにもコンパイル可能。
PythonとTypeScriptから、プロンプトや構造化出力、ツール利用向けのデコレーターを使って、あらゆる最先端LLMを統一インターフェースで呼び出せるツールキット。
Python、.NET、JavaでAIエージェントやマルチエージェントシステムを構築するためのSDK。モデル、プラグイン、ベクトルデータベースと連携できます。
モデル、埋め込み、ベクトルストア、サードパーティ連携の標準インターフェースを備えた、LLMアプリケーションやエージェント構築用のPythonフレームワーク。