フルスタックAIエージェントテンプレート

何であるか – AIエージェント機能、Retrieval-Augmented Generation（RAG）、認証、課金、監視、デプロイツールなどを事前に設定済みの、完全なプロダクション対応のウェブアプリ（FastAPIバックエンド + Next.jsフロントエンド）を生成するコマンドラインジェネレータ。生成されたプロジェクトはDockerでローカル実行可能であり、Kubernetesにデプロイすることも可能。また、チャット、チーム/ワークスペース管理、知識ベースのインジェスト、管理者ダッシュボードを備えた豊富なUIを提供する。

---

🎯 コアの目的

このテンプレートにより、開発者はフルスタックAIエージェントSaaSを数分で立ち上げ、通常のインフラ整備（認証、DB、RAG、CI、モニタリングなど）に時間を費やすことなく、ドメイン固有のロジックに集中できる。

---

🚀 クイックスタート（READMEから）

1. ジェネレータのインストール

   pip install fastapi-fullstack   # または `uv tool install fastapi-fullstack`
   

2. プロジェクトの作成 – インタラクティブなウィザードに答える（またはフラグを渡す）:

   fastapi-fullstack               # `my_ai_app` をスケルトン化
   

3. スタックのブートストラップ

   cd my_ai_app
   make bootstrap                 # Dockerイメージのビルド、DBの起動、マイグレーションの実行、管理者のシード
   

4. UIの実行（別のターミナルで）

   cd frontend && bun install && bun dev   # または `make dev-frontend`
   

5. サービスを開く:
   • APIドキュメント: http://localhost:8000/docs
   • 管理者UI: http://localhost:8000/admin（admin@example.com / admin123）
   • フロントエンド: http://localhost:3000

---

🛠️ 主な機能（一覧）

カテゴリ	何が得られるか
AIエージェントフレームワーク	5つのランタイムをサポート – Pydantic AI、Pydantic Deep Agents、LangChain、LangGraph、DeepAgents。
RAGパイプライン	プラグアンドプレイ型ベクトルストア（Milvus、Qdrant、pgvector、ChromaDB）と自動チャンク化・埋め込み処理。
ウェブスタック	WebSocketストリーミング対応のFastAPI 15バックエンド、Next.js 15フロントエンド、リアルタイムチャットUI。
会話の共有	公開リンク、管理者専用のブラウザビュー、チャットセッションのエクスポート/共有。
エンタープライズ対応	JWT + OAuth、管理者パネル、Celeryタスクキュー、DockerおよびKubernetes設定、環境別composeファイル。
オブザーバビリティ	使い方ダッシュボード、トークン単位の会計、Stripe課金連携、アクティビティログ。
CLIおよびDjango風管理	サーバー起動、DBマイグレーション、ユーザー作成などに対応する my_ai_app コマンド。
アップグレードパス	make upgrade で上流のテンプレート変更を既存プロジェクトにマージ可能。カスタムコードは失われない。
拡張性	フィーチャフラグ（例: enable_marketing_site）により、マーケティングランディングページ、SaaS課金、チームワークスペースなどを追加可能。

---

📂 生成されたプロジェクト構造（概要）

my_ai_app/
├─ backend/          # FastAPIアプリ、Pydanticモデル、Celeryワーカー
│   ├─ app/
│   ├─ alembic/      # DBマイグレーション
│   ├─ Dockerfile
│   └─ Makefile
├─ frontend/         # Next.js（React）UI、Tailwind、WebSocketクライアント
│   ├─ pages/        # チャット、ダッシュボード、管理者、課金など
│   ├─ components/
│   └─ Dockerfile
├─ docker-compose.dev.yml   # 開発用スタック（db、redis、milvus、…）
├─ docker-compose.prod.yml  # 本番用スタック
└─ makefile          # 開発、本番、アップグレードなどのショートカット

このリポジトリは PyPIパッケージ（fastapi-fullstack）も同梱しており、スケルトン生成ロジックを含む。

---

🤖 AIエージェントの詳細

• エージェントコードはバックエンドにあり、生成時に選択可能（例: pydantic_deep）。
• エージェントは応答をストリーミング可能、ツール呼び出し、ユーザーの確認を待機（ask_user）、Pythonスニペットの実行、サブエージェントの生成が可能。
• UIでは各ツール呼び出しをカードとしてレンダリングし、リアルタイムの計画・タスクチェックリストを表示し、チャートやコード出力をインラインで可視化する。

---

📚 ドキュメントとエコシステム

• ドキュメントサイト – https://vstorm-co.github.io/full-stack-ai-agent-template/（インストール手順、アップグレードガイド、APIリファレンス）。
• Vstorm OSSエコシステムの一部 – AgenticOS、pydantic-deepagents、pydantic-ai-shields などの関連プロジェクトが、基盤ランタイム、ガードレール、サンドボックス機能を提供。
• CIバッジで100％のテストカバレッジを示し、OpenSSFベストプラクティスバッジにより成熟したオープンソースプロセスを確認可能。

---

🏁 使うべきタイミング

• AIアシスタント製品（カスタマーサポートボット、データアナリスト、コードアシスタントなど）向けの完成済みSaaSスケルトンが必要な場合。
• 認証、マルチテナントワークスペース、Stripe課金などのエンタープライズ機能をゼロから構築せずに利用したい場合。
• スタックを1つのコマンドで最新化し、後からアップグレードしたい場合。

---

📦 パッケージング方法

• ジェネレータはPyPI上で fastapi-fullstack として配布（pip、uv、pipxでインストール可能）。
• 生成されたアプリはDockerでコンテナ化され、オプションでKubernetesマニフェストも含まれる。

---

📌 TL;DR

vstorm-co/full-stack-ai-agent-template は本格的でプロダクション対応のプロジェクトであり、AIエージェント、RAG、認証、課金、デプロイが事前に設定された完全なFastAPI + Next.jsアプリを生成する。AIエージェントSaaS製品を開発するチームを対象とし、生成されたコードの明確なアップグレードパスを提供する。