rm -rf venv python3 -m venv venv source venv/bin/activate pip install -r requirements.txt pip3 install --upgrade jupyter python3 -m ipykernel install --user --name=python3 Troubleshooting Common Issues | Problem | Solution | |---------|----------| | command not found: python | Use python3 or create alias | | SSL certificate errors | /Applications/Python\ 3.x/Install\ Certificates.command | | pip not found | python3 -m ensurepip --upgrade | | Permission denied | Use --user flag: pip3 install --user package | Quick One-Liner (Homebrew) brew update && brew upgrade python && python3 --version Best for most users: Homebrew (Method 1) Best for developers: Pyenv (Method 3) Best for simplicity: Official installer (Method 2)
alias python=python3 alias pip=pip3 Then reload: upgrade python mac
export PATH="/Applications/Python 3.12/bin:$PATH" alias python=python3 Perfect for developers who need to switch between Python versions. Install Pyenv brew install pyenv Add to Shell Config echo 'export PYENV_ROOT="$HOME/.pyenv"' >> ~/.zshrc echo 'command -v pyenv >/dev/null || export PATH="$PYENV_ROOT/bin:$PATH"' >> ~/.zshrc echo 'eval "$(pyenv init -)"' >> ~/.zshrc source ~/.zshrc Install & Set Python Version pyenv install 3.12.2 # Replace with latest pyenv global 3.12.2 python --version Clean Up Old Versions Remove Python 2 (if present) sudo rm -rf /System/Library/Frameworks/Python.framework/Versions/2.7 sudo rm -rf /usr/local/bin/python Clean Homebrew Python brew cleanup python Post-Upgrade Checklist 1. Update pip python3 -m pip install --upgrade pip 2. Reinstall Global Packages pip3 freeze > old_packages.txt # After upgrade: pip3 install -r old_packages.txt 3. Fix Virtual Environments For each venv: rm -rf venv python3 -m venv venv source
After upgrading, verify with python3 --version and enjoy the latest features, security fixes, and performance improvements! 🚀 Reinstall Global Packages pip3 freeze > old_packages
Here’s a complete guide to upgrading Python on a Mac, covering multiple methods with pros and cons. Homebrew gives you the latest Python, easy updates, and better package management. Install/Update Homebrew /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" brew update brew upgrade Install Latest Python brew install python This installs Python 3.12+ as python3 . Switch to New Python (Optional) Add to ~/.zshrc or ~/.bash_profile :