FastAPIとは?|FastAPIのインストール方法|Windowsで動かすまでの手順


FastAPIってどんなもの?

FastAPIは、PythonでWeb APIを開発するためのフレームワークです。

Web APIというのは、ざっくり言うと「URLにアクセスすると、データを返してくれる窓口」のようなもの。
画面(フロントエンド)から「このデータちょうだい」とお願いされたときに、裏側で返事をする役割です。

フレームワークとは、アプリを作るときの「土台」や「型」のようなものです。
よく使う処理があらかじめ用意されているので、ゼロから全部書かなくて済みます。


FastAPIの強み

高速なパフォーマンス

非同期処理と、Starletteが採用するASGI(Asynchronous Server Gateway Interface)を土台にしているため、高いパフォーマンスが出せます。

  • 非同期サポート:非同期プログラミングに対応していて、大量の同時接続もスムーズにさばける
  • 高スループット:リクエストからレスポンスまでの処理が速く、アプリ全体の性能アップにつながる

簡単なコード記述

Pythonの型ヒント(type hints)を使って、直感的にコードを書けます。

  • 自動バリデーション:リクエストデータのチェックを自動でやってくれるので、チェック処理を自分で書く手間が減る
  • ドキュメント自動生成:Swagger UIやReDocのAPIドキュメントが自動で作られ、APIの仕様をすぐ確認できる

高い生産性

開発スピードとコードの保守性を上げる機能がそろっています。

  • 自動補完:型ヒントのおかげでエディタの自動補完が効きやすく、開発がはかどる
  • シンプルな依存性注入:依存関係(DB接続など)の管理がシンプルで、テストやモックへの差し替えがしやすい

豊富な機能セット

Web APIでよく使う機能が標準でそろっていて、多くの要件に対応できます。

  • セキュリティ機能:OAuth2などの認証・認可を組み込むための仕組みが用意されている(JWTの処理にはPyJWTなどのライブラリを併用)
  • データベース対応:SQLAlchemyやTortoise ORMなど、さまざまなデータベースライブラリと組み合わせられる

活発なコミュニティとサポート

活発なコミュニティに支えられていて、情報やサポートが豊富です。

  • ドキュメント:公式ドキュメントが詳しく、学習にも問題解決にも役立つ(日本語訳のページもある)
  • コミュニティサポート:GitHubやStack Overflowで活発に議論されていて、困ったときに解決策を見つけやすい

今回の環境

項目内容
OSWindows 11
ターミナルPowerShell
Python3.11.9(以前にインストール済み)
FastAPI0.141.1

FastAPIを使うには、Python 3.10以上が必要です(2026年9月時点)。
古いPythonが入っている場合は、先にバージョンアップしておきましょう。


FastAPIをインストールする手順

ここからは、実際にやった手順です。
全部で6ステップあります。

手順1:Pythonのバージョンを確認する

まずは、Pythonが入っているか、バージョンは足りているかを確認します。

py --version

私の環境では Python 3.11.9 と表示されました。
3.10以上ならOKです。

手順2:作業用のフォルダを作る

FastAPIの練習用フォルダを作って、そこに移動します。
フォルダ名はなんでも大丈夫です。

mkdir fastapi-practice
cd fastapi-practice

手順3:仮想環境を作って有効にする

次に、このフォルダ専用の仮想環境を作ります。

py -m venv .venv
.venv\Scripts\Activate.ps1

うまく有効になると、行の先頭に (.venv) と表示されます。

仮想環境とは、プロジェクトごとに専用のPython置き場を作る仕組みです。
ここに入れたライブラリは他のプロジェクトに影響しないので、「あっちで入れたら、こっちが動かなくなった」を防げます。

PowerShellの設定によっては、「このシステムではスクリプトの実行が無効になっているため…」というエラーが出ることがあります。
その場合は、PowerShellのスクリプト実行ポリシーの設定を見直す必要があります。
会社のPCでは勝手に設定を変えず、社内のルールを確認してください。

手順4:FastAPIをインストールする

仮想環境が有効になった状態で、FastAPIをインストールします。

pip install "fastapi[standard]"

[standard] を付けると、FastAPI本体と一緒に、開発でよく使うものがまとめて入ります。
アプリを動かすためのサーバー(Uvicorn)や、fastapi コマンドもここに含まれています。

"fastapi[standard]" は、ダブルクォートで囲むのがおすすめです。
公式ドキュメントでも、ターミナルで正しく動くように囲んでおくよう書かれています。

インストールできたかどうかは、次のコマンドで確認できます。

pip show fastapi

私の環境では Version: 0.141.1 と表示されました。
バージョンが出れば成功です。

手順5:動作確認用のコードを書く

フォルダの中に main.py というファイルを作って、次のコードを書きます。

from fastapi import FastAPI

app = FastAPI()


@app.get("/")
def read_root():
    return {"Hello": "World"}

やっていることはシンプルで、「/ にアクセスされたら {"Hello": "World"} を返す」だけです。
@app.get("/") の1行で、「このURLに来たら、この関数が動く」と決まります。

手順6:起動してブラウザで確認する

いよいよ起動です。

fastapi dev main.py

ターミナルに http://127.0.0.1:8000 のようなアドレスが表示されたら、起動成功です。

ブラウザで http://127.0.0.1:8000 を開くと、こんな画面が表示されます。

ブラウザで http://127.0.0.1:8000 を開き、{"Hello":"World"} と表示された画面
※画面はイメージです

ブラウザからURLにアクセスすると、さっき書いた関数が動いて、返事が返ってきました。
これで作成したAPIがきちんと動作したことを確認できました。

止めるときは、ターミナルで Ctrl + C を押します。


自動で作られるドキュメント画面もさわってみた

FastAPIを選んだ理由のひとつ、自動ドキュメントも見てみます。

サーバーを起動したまま、ブラウザで次のURLを開いてみてください。

http://127.0.0.1:8000/docs

すると、APIの一覧が見られるドキュメント画面(Swagger UI)が表示されます。

http://127.0.0.1:8000/docs で表示される、FastAPIの自動ドキュメント画面(Swagger UI)
※画面はイメージです

画面の「Try it out」→「Execute」と押すと、その場でAPIを呼び出して結果まで確認できます。
本業では仕様書を手で書くことも多いので、「コードを書いたら説明書も勝手にできる」のはかなりありがたいです。


まとめ

今回やったことをまとめると、こんな流れでした。

  1. Pythonのバージョンを確認(3.10以上)
  2. 作業用フォルダを作る
  3. 仮想環境を作って有効にする
  4. pip install "fastapi[standard]" でインストール
  5. main.py に最小のコードを書く
  6. fastapi dev main.py で起動して、ブラウザと /docs で確認

コメント

タイトルとURLをコピーしました