```
pyenv install --list
```
This command lists every version of Python that can currently be installed through pyenv. This includes most Python2 versions, and all Python3 versions. This is a useful command which can ensure that the correct versions of Python for any specific set(s) of dependencies are available.

pyenv install --list

```
pyenv install 3.x.x~
```
This command will install the specified version of Python3. This can also be used to install different versions of Python2. The command would be very similar, simply replacing the “3” with a “2”
```
pyenv install 2.x.x~
```
Note: Each tilde (~) indicates a possible letter (it is possible that there is an additional digit after this letter). This only pertains to pyenv-win (Windows users).

pyenv install 3.x.x~

```
pyenv versions
```
This command will list all versions of Python currently installed on your machine (through pyenv). It will also mark which version is currently set as the default in the current working directory. If there is no specific version set for the working directory, it will mark the system version of Python (if one exists) or any other version of Python that has already been installed.

pyenv versions

```
pyenv global (3.x.x~)
```
```pyenv global``` by itself lists which version of Python is currently set as the “global” version. The “global” version simply indicates which version of Python to default to when called in directories where there are no “local” versions of Python set (directories where a specific version of Python is set to default). It is important to note that local Python versions will always have priority over the global version. Adding a specific version of Python to the command will set the global Python version to the specified version in the command.
```
pyenv global (3.x.x~)

pyenv global (3.x.x~)

```
pyenv local (3.x.x~)
```
```pyenv local``` by itself lists which version of Python is currently set as the “local” version. The “local” version simply indicates which version of Python to default to when called in directories where there are “local” versions of Python set. It is important to note that local Python versions will always have priority over the global version. Adding a specific version of Python to the command will set the local Python version to the specified version in the command. Make sure you are in the correct directory when using this command, otherwise a different Python version could inadvertently be set as local in the incorrect directory.
```
pyenv local (3.x.x~)

pyenv local (3.x.x~)

This branch of nodes will cover pyenv usage/commands. These commands work regardless of machine/operating system.
```
pyenv install --list
pyenv install 3.x.x~
pyenv versions
pyenv global (3.x.x~)
pyenv local (3.x.x~)
```
Note: Each tilde (~) indicates a possible letter (it is possible that there is an additional digit after this letter). This only pertains to pyenv-win (Windows users).

pyenv is an open-source Python version management tool for the command-line. It allows for the changing of both global and local versions of Python, and resolves the issue of different local Python projects supporting different versions of Python. It also allows for the installation of any currently supported or legacy version of Python. macOS machines utilize pyenv whereas Windows machines must use pyenv-win.

pyenv

pyenv-win Documentation (Windows Version)

pyenv Documentation (macOS Version)

A plugin is available for pyenv known as ```pyenv-virtualenv```, which allows one to manage their virtual environments through pyenv. What sets this method of managing virtual environments apart from others such as ```venv``` is that pyenv allows one to specify the version of python used for the virtual environment, whereas others will use whatever version is currently installed locally.

Learn Before

Related

Learn After