Python で手書きしたエンタープライズ向け Agent システム実装：32 課で非同期・分散・可観測・安全な Agent ランタイムを会社規模で運用可能な状態まで構築できます。
中辛 の解説
このプロジェクトは、エンタープライズ Agent システムの構築を学べるインタラクティブな講座です。全 32 課（約 12 時間）で、Python での実装を通じて非同期並行処理・マルチプロセス化・状態管理・安全性・監視を段階的に習得します。まず第一部（約 2.5 時間）で async エージェントループ・ツール設計・コンテキスト管理の基礎を実装し、第二部（約 3 時間）で 429 エラー対応・注入攻撃防御・権限制御・分散実行など 9 つの企業課題を 2～4 種類の設計パターンで比較検討します。第三部（約 3.5 時間）は検索品質・記憶システム・MCP・コード実行・エージェント最適化、第四部（約 3 時間）は Postgres・Redis・Temporal・OpenTelemetry への段階的な置き換えと真実のマルチプロセス故障シミュレーションです。各課には自動テスト付き演習があり、オフライン実行・決定論的・無料です。
こんなリポジトリです
こんなときに便利です
- IT サービスデスク Agent を複数プロセスで運用し、mark -9 クラッシュ後も暫停中の承認ステップから自動復帰させるシステムの構築
- 429 レート制限・モデル宕機・ユーザー入力注入攻撃に対応する Agent の設計・検証・本番デプロイの意思決定
- Postgres・Redis・Temporal への段階的な移行で単機 SQLite 版から複数台分散実行まで同一インターフェースで拡張する
主な機能
ほかとの違い
フレームワークの黒箱 API 呼び出しではなく、企業本番環境で実装が必須な非同期・分散・フェンシング・フック型権限管理・トレース・評価フレームワークの全層を手書きして理解し、その後 Postgres・Redis・Temporal など成熟コンポーネントへの段階的置き換えを同一インターフェースで実践できる点です。
このリポジトリの作り方
はじめてですか？ むずかしくありません — 上から順にたどれば、自分の環境で動かして味見できます。
準備するもの
- Python 3.10 以上
- OpenAI 互換の LLM エンドポイント（デモ用；演習・テストはオフラインで実行可能）
- Docker（オプション・第 31 課の本番デプロイメント用）
すぐに始める
- リポジトリをクローンして依存関係をインストールします。
git clone https://github.com/heaven999b/hello-agent-system.git
cd hello-agent-system
make setup
- .env ファイルを編集して OpenAI 互換の LLM エンドポイント設定を入力します。
LLM_BASE_URL=https://api.openai.com/v1
LLM_API_KEY=sk-xxx
LLM_MODEL=gpt-4o-mini
- LLM 接続を確認します。
make check-env
- 最初のデモを実行します。
.venv/bin/python lessons/00_overview/demo.py
- API キーがない場合は、全デモが
--offlineフラグをサポートしており、オフライン用スクリプト化 LLM で実行できます。全ての演習とテストはオフラインで実行可能です。
ギット飯トライで味見
入れるのが面倒で少し不安だったなら — 安全スキャンからインストールまで、ターミナル一行で終わります。
ターミナルに貼り付ければ、ギット飯の安全スキャン → 隔離フォルダへ clone → インストール → 実行方法の案内まで自動です。はじめてでも大丈夫 — この一行だけです。
npx gitbap-try heaven999b/hello-agent-system
Node.js さえあれば、インストールなしで動きます · ギット飯トライとは？ →
スター推移 · 7日
確認日時
使いやすさ · まねしやすいか
- ゆるいライセンス
- テストあり
- サンプル集
- 最近の更新
- AGENTS.md
- llms.txt
- テンプレート
最近の更新あり · 2026 年に作成
「LLM ツール・RAG」 こういうリポジトリを毎週受け取りませんか？
毎週月曜の朝、選んだ一膳だけ。広告なし · いつでも解除。
自分のリポジトリですか？ README にギット飯バッジを貼る
[](https://www.gitbap.com/r/heaven999b/hello-agent-system)Claude からそのまま使う — ギット飯のつなぎ方
ギット飯を Claude につなぐと、こうしたリポジトリを Claude・Cursor・Codex から直接さがして試せます。
Claude の設定 → コネクタにこのアドレスを貼り付け。
https://www.gitbap.com/api/mcpプラグインを入れると /gitbap-trending·/gitbap-try のスラッシュコマンドで、その場でリポジトリを試せます。Claude Code で下の 2 行を順に実行してください。
/plugin marketplace add jakeparkcolde/gitbap-cowork/plugin install gitbap-cowork@gitbapAI が README をもとに要約しました · 原文を見る