GitHub - llbbl/setup-python: notes on setting up python

Python Setup for macOS

Guides for setting up a clean, maintainable Python development environment on macOS.

Guides

python-setup-macos.md - The recommended setup using pyenv + Poetry
python-setup-mise.md - Alternative setup using mise (polyglot version manager)

Quick Start

For most users, follow the pyenv guide:

# Install pyenv
brew install pyenv

# Add to ~/.zshrc
export PYENV_ROOT="$HOME/.pyenv"
command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"
eval "$(pyenv init - zsh)"

# Install Python
pyenv install 3.11.11
pyenv global 3.11.11

# Install Poetry
curl -sSL https://install.python-poetry.org | python3 -

Tooling Summary

Task	Tool
Python version management	pyenv (or mise)
Project dependencies	Poetry
Global CLI tools	pipx

License

MIT