starlette-admin レビュー: FastAPI に管理画面を足すなら、まず検討したい選択肢

FastAPI に管理画面がない問題への回答

FastAPI は API エンドポイントを素早く書ける一方で、データを編集するための画面は標準では提供されません。開発中にレコードを直したい、運用担当者にデータを触らせたい、といった場面で、管理画面を一から作るのは手間です。starlette-admin はこの穴を埋めるためのフレームワークで、モデル定義から CRUD ページを自動生成します。対象は FastAPI と Starlette を使う開発者で、特に SQLAlchemy か SQLModel を使っている場合が想定ユーザーです。README のクイックスタートでは、モデルクラスを定義して Admin と ModelView を登録するだけで、/admin にダッシュボードが現れる例が示されています。

生成される画面の実装方式

starlette-admin はモデルごとに ModelView を登録し、そのビューが一覧、詳細、作成、編集、削除の各画面を提供します。一覧画面にはページネーション、ソート、検索、共有可能な URL が付属します。フィルタは AND と OR をネストして組み立てられるのが特徴です。関連モデルのインライン編集、バルク操作、行ごとのカスタムアクションも定義できます。エクスポートは CSV、Excel、JSON、PDF に対応し、インポートは CSV、JSON、Excel で、実行前にドライラン検証ができるとされています。これらの機能はすべて contrib パッケージとして分離されており、SQLAlchemy 用は starlette_admin.contrib.sqla にあります。

対応バックエンドと agnostic 設計の実際

README の表によると、SQLAlchemy、SQLModel、Tortoise ORM、Beanie、MongoEngine が公式にサポートされています。Beanie は MongoDB 用、MongoEngine も MongoDB 用です。つまり SQL 系と NoSQL 系の両方をカバーする設計です。さらに独自のデータソースを使いたい場合は BaseModelView をサブクラス化します。ここで注意したいのは、agnostic と言っても各 contrib の成熟度は均一ではない可能性がある点です。SQLAlchemy がクイックスタートの主役である一方、Beanie や MongoEngine のドキュメントが同じ深さで整備されているかは、README だけからは確認できません。採用前に、使いたい ORM の contrib が自分のモデル定義で動くかを小さなサンプルで試すのが現実的です。

インストールから画面表示までの手順

インストールは uv なら uv add starlette-admin、pip なら pip install starlette-admin です。クイックスタートでは SQLAlchemy のエンジンを作り、DeclarativeBase を継承したモデルを定義し、starlette_admin.contrib.sqla から Admin と ModelView をインポートします。Admin にエンジンを渡し、ModelView を add_view で登録する流れです。fastapi dev で起動し、http://127.0.0.1:8000/admin を開くとダッシュボードが表示されます。認証やファイルストレージの設定はユーザーガイドに記載されていますが、README のクイックスタートには含まれていません。最小構成で動かす分には、モデル定義とビュー登録の2ステップで済むのが利点です。

イベントフックと認証の拡張ポイント

CRUD 操作の前後に処理を挟むイベントフックが用意されています。たとえば作成前にデフォルト値を設定する、削除後にキャッシュを破棄する、といった処理をここに書けます。認証はプラグイン方式で、認証、ストレージ、フィールド、アクション、モデルビューをそれぞれ差し替えられます。S3 互換のストレージにも対応しており、MinIO や Amazon S3 が挙げられています。テーマのカスタマイズ、ダークモード、国際化、タイムゾーン対応も機能リストに含まれます。ただし、認証プラグインの具体的な実装方法や、イベントフックのシグネチャは README には書かれておらず、ユーザーガイドの views の章を参照する必要があります。

制約: ドキュメント依存とバージョン 1.0 の時期

このプロジェクトの最大の制約は、情報源が公式ドキュメントと README に限られることです。実際の動作やパフォーマンスは、この記事の執筆時点では未検証です。また、1.0.0 は 2026 年 8 月 16 日にリリースされたばかりで、1.0.1 が同月 25 日に出ています。安定版になった直後ということは、API が固まった一方で、実際の利用者がまだ多くない可能性があります。バージョンアップに伴う破壊的変更がどの程度あるかは、リリースノートを確認する必要があります。さらに、PDF エクスポートや S3 ストレージは追加の依存パッケージが必要になる可能性が高く、README にはその記載がありません。

代替案との比較: Django Admin と Flask-Admin

Python の管理画面フレームワークとして有名なのは Django Admin です。しかし Django Admin は Django プロジェクト専用で、FastAPI とは統合できません。FastAPI を使っている時点で、Django を導入するのはフレームワークごと乗り換えることになります。もう一つの代替は Flask-Admin ですが、こちらも Flask 向けです。starlette-admin の利点は、FastAPI と Starlette の上で動く点にあります。既存の FastAPI アプリに管理画面を足す場合、フレームワークを追加するのではなく、このライブラリを追加するだけで済みます。ORM の agnostic 設計も、SQLAlchemy から Tortoise ORM に移行する場合に、ビュー層を書き直さずに済む可能性を示唆します。

メンテナンスコストとライセンスの確認点

ライセンスは MIT です。商用利用、改変、再配布に制約が少ないのは利点です。ただし、ライセンスの詳細な条件はプロジェクト自身の LICENSE ファイルで確認してください。メンテナンスコストとしては、ORM のバージョンアップに追随する必要があります。SQLAlchemy や Tortoise ORM のメジャーアップデートで API が変わった場合、starlette-admin の contrib が追従しているか確認する作業が発生します。また、1.0 系がリリースされたばかりなので、API の安定性はまだ実績で証明されていません。導入する際は、ピン留めしたバージョンでテストを書き、アップグレード時に差分を確認する運用が現実的です。

編集部の結論

FastAPI でモデル管理画面を短期間で用意したいチームには starlette-admin が有力な候補です。SQLAlchemy か SQLModel を使っていて、CSV や Excel の入出力、AND/OR フィルタ、認証プラグインといった機能を標準で揃えたいなら、導入コストは低いです。一方で、MongoDB 系のバックエンドを使う場合や、独自のデータソースを操作する場合は Beanie や MongoEngine 用の contrib を確認するか、BaseModelView のサブクラス化が必要です。採用前に、対象の ORM バージョンと starlette-admin の対応状況、そしてイベントフックの仕様が自前のビジネスロジックと噛み合うかを、公式ドキュメントのユーザーガイドで確認してください。このプロジェクトは 2026 年 8 月に 1.0.0 をリリースしたばかりで、バージョン 1.0.1 が最新です。安定版になった直後という時期を踏まえ、導入時点のリリースノートと既知の問題を確認するのが現実的な次の一手です。

公式情報源

1. Official documentation
2. Official README
3. Project repository
4. Release notes