インストールしたい（python3）

$ brew install python3
$ pip3 install -U pip

$ brew install pipx
$ brew link pipx
$ pipx ensurepath

PythonはHomebrewを使ってインストールします。 パッケージ管理ツールのpip3を最新版にし、またpipxもインストールします。

$ which python3
/opt/homebrew/bin/python3
$ python3 --version
Python 3.11.3

$ which pip3
/opt/homebrew/bin/pip3
$ pip3 --version
pip 23.1.2 from /opt/homebrew/lib/python3.11/site-packages/pip (python 3.11)

$ which pipx
/opt/homebrew/bin/pipx
$ pipx --version
1.2.0

パッケージ管理したい

// pip (not recommended)
// global environment
$ pip3 install -U commitizen

// pipx (recommended)
// isolated global environment for each package
$ pipx install commitizen
$ pipx install pytest

// poetry (recommended)
// package management via poetry
$ poetry add pandas
$ poetry add --group dev commitizen
$ poetry add --group dev pytest
$ poetry add --group docs zensical
$ poetry install

// uv pip (most recommended)
// pip alternative
$ uv pip install commitizen

// uv (most recommended)
// package management via uv
$ uv add pandas
$ uv add --dev commitizen
$ uv add --dev pytest
$ uv add --group docs zensical
$ uv sync

Pythonのパッケージ管理はさまざまあります。 標準ツールはpipですが、依存関係の管理が得意ではないため、オススメできません。

プロジェクトごとに依存関係を含めて管理したい場合はpoetryやuvがオススメです。 poetryがデファクトスタンダードになりつつありますが、最近はuvも注目されている印象です。

このドキュメントにあるパッケージの追加手順も、 そのページを最終更新した時期に強く依存しており、統一しきれていません。 今後はuvを使う方向で揃えていきたいと思いますが、適切に読み換えてください。

バージョン管理したい（uv python）

// uvをインストール（1回だけ）
$ brew install uv

// Python本体をインストール
$ uv python install 3.12

// インストール済みのバージョンを確認
$ uv python list

uv自体がPythonのバージョン管理機能を持っており、 uv python installでPython本体をインストールできます。 Homebrewやpyenvを使わなくても、uvひとつで Python本体のインストールからパッケージ管理・仮想環境の作成までを完結できます。

// バージョンを指定してプロジェクト用の仮想環境を作成
$ uv venv --python 3.12

uv venv --pythonで、指定したバージョンのPythonを使った仮想環境を作成できます。 バージョンが未インストールの場合は自動でダウンロードされます。

参考

詳細はパッケージ管理したい（uv）に整理しました。