Guides for setting up a clean, maintainable Python development environment on macOS.
- python-setup-macos.md - The recommended setup using pyenv + Poetry
- python-setup-mise.md - Alternative setup using mise (polyglot version manager)
For most users, follow the pyenv guide:
# Install pyenv
brew install pyenv
# Add to ~/.zshrcexport 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 -| Task | Tool |
|---|---|
| Python version management | pyenv (or mise) |
| Project dependencies | Poetry |
| Global CLI tools | pipx |
MIT