Skip to content

uv

FastAPI の前に Python 開発環境を整える。

uv のインストール

基本的には uv を使ってセットアップしていく。
uv はインストールが必要なので、 https://docs.astral.sh/uv/getting-started/installation/ にある通りにインストールしておく。

  • macOSを使ってるなら下記のコマンドを実行 
    curl -LsSf https://astral.sh/uv/install.sh | sh

    source $HOME/.local/bin/env
  • インストールできたか確認 
    uv --version

プロジェクトの作成と初期化

uv が使えるようになったら、プロジェクトフォルダを作成して移動しておく。 

mkdir my-fastapi-app && cd my-fastapi-app

プロジェクトの初期化 

uv init

Python のバージョン指定

Python のバージョンを指定するときは下記のようにオプションをつければ OK 。 

uv init --python 3.13

初期化後は下記のファイルとディレクトリが作成される 

.git
.gitignore
.python-version
main.py
pyproject.toml
README.md

Note

もし、 Git で管理しないプロジェクトなら .git ディレクトリを削除しておけば OK 。

Pythonパッケージのインストール例

これ以降は uv コマンドを使って Python パッケージをインストールする FastAPI をインストールしてみる。 

uv add "fastapi[standard]"

仮想環境を有効化しなくても OK

python コマンドとか、 uv で追加したパッケージのコマンドを実行する時は、 uv run を先頭につければ実行できる。

# (例)
% fastapi --version
zsh: command not found: fastapi
% uv run fastapi --version
FastAPI CLI version: 0.0.24

パッケージを追加すると、 pyproject.toml が更新されて、 uv.lock が作成されるので、この 2 つのファイルもソースコードと一緒に GitHub とかにあげておけば、他の人が同じ環境を構築するときとか、デプロイするサーバーに同じ環境を構築するときに使える。

uv sync コマンド

uv sync コマンドを使うと、 pyproject.toml のパッケージ一覧を元に、 uv.lock の内容を反映した仮想環境を構築できるので、 uv さえインストールしておけば同じ環境を構築できる。

uv sync