Python

pyenv Commands

Install and manage multiple Python versions on your system. Switch between versions per-project or globally.

9 commands

Pro Tips

Use 'pyenv local 3.11.0' to pin Python version for a project (.python-version file).

Run 'pyenv rehash' after installing new packages with executables.

Install pyenv-virtualenv plugin for integrated virtualenv management.

Common Mistakes

pyenv compiles Python from source - ensure build dependencies are installed.

On macOS, install Xcode Command Line Tools before using pyenv.

Commands

List available versions

$ pyenv install --list

Show all available Python versions.

Install Python version

$ pyenv install 3.12.0

Install a specific Python version.

List installed versions

$ pyenv versions

Show all installed Python versions.

Set global version

$ pyenv global 3.12.0

Set Python version for all shells.

Set local version

$ pyenv local 3.11.0

Set Python version for current directory.

Set shell version

$ pyenv shell 3.10.0

Set Python version for current shell session.

Show current version

$ pyenv version

Display currently active Python version.

Uninstall version

$ pyenv uninstall 3.9.0

Remove an installed Python version.

Rehash shims

$ pyenv rehash

Rebuild shims after installing packages with executables.