pyenv lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of single-purpose tools that do one thing well.
pyenv is a great tool. We have ported it to Windows. We need your thoughts to improve this library and your feedback helps to grow the project.
For existing python users, we support installation via pip.
Contributors and Interested people can join us on @Slack. Your help keeps us motivated!
pyenv for python is a great tool but, like rbenv for ruby developers, it doesn't directly support Windows. After a bit of research and feedback from python developers, I discovered they wanted a similar feature for Windows systems.
This project was forked from rbenv-win and modified for pyenv. It is now fairly mature, thanks to help from many different contributors.
pyenv is a simple python version management tool. It lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of single-purpose tools that do one thing well.
commands List all available pyenv commands
local Set or show the local application-specific Python version
global Set or show the global Python version
shell Set or show the shell-specific Python version
install Install 1 or more versions of Python
uninstall Uninstall 1 or more versions of Python
update Update the cached version DB
rehash Rehash pyenv shims (run this after switching Python versions)
vname Show the current Python version
version Show the current Python version and its origin
version-name Show the current Python version
versions List all Python versions available to pyenv
exec Runs an executable by first preparing PATH so that the selected Python
which Display the full path to an executable
whence List all Python versions that contain the given executable
Currently we support following ways, choose any of your comfort:
Hurray! When you are done here are steps to Validate
NOTE: If you are running Windows 10 1905 or newer, you might need to disable the built-in Python launcher via Start > "Manage App Execution Aliases" and turning off the "App Installer" aliases for Python
The easiest way to install pyenv-win is to run the following installation command in a PowerShell terminal:
Invoke-WebRequest -UseBasicParsing -Uri "https://raw.githubusercontent.com/pyenv-win/pyenv-win/master/pyenv-win/install-pyenv-win.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
If you are getting any UnauthorizedAccess error as below then start Windows PowerShell with the "Run as administrator" option and run Set-ExecutionPolicy -ExecutionPolicy RemoteSigned -Scope LocalMachine, now re-run the above installation command.
& : File C:\Users\kirankotari\install-pyenv-win.ps1 cannot be loaded because running scripts is disabled on this system. For
more information, see about_Execution_Policies at https:/go.microsoft.com/fwlink/?LinkID=135170.
At line:1 char:173
+ ... n.ps1" -OutFile "./install-pyenv-win.ps1"; &"./install-pyenv-win.ps1"
+ ~~~~~~~~~~~~~~~~~~~~~~~~~
+ CategoryInfo : SecurityError: (:) [], PSSecurityException
+ FullyQualifiedErrorId : UnauthorizedAccess
For more information on 'digitally signed' or 'Security warning' you can refer to following issue #332
Installation is complete!
The default way to install pyenv-win, it needs git commands you need to install git/git-bash for windows
If you are using PowerShell or Git Bash use $HOME instead of %USERPROFILE%
git clone using command prompt git clone https://github.com/pyenv-win/pyenv-win.git "%USERPROFILE%\.pyenv"
steps to add System Settings
Note: Don't forget the check above link, it contains final steps to complete.
Installation is complete!
Manual installation steps for pyenv-win
If you are using PowerShell or Git Bash use $HOME instead of %USERPROFILE%
Download pyenv-win.zip
Create a .pyenv directory using command prompt mkdir %USERPROFILE%/.pyenv if not exist
Extract and move files to %USERPROFILE%\.pyenv\
Ensure there is a bin folder under %USERPROFILE%\.pyenv\pyenv-win
steps to add System Settings
Note: Don't forget the check above link, it contains final steps to complete.
Installation is complete!
For existing python users
If you are using PowerShell or Git Bash use $HOME instead of %USERPROFILE%
installation command via command prompt
pip install pyenv-win --target %USERPROFILE%\\.pyenv
if you having an error on above command use the folllowing to resolve it. ref. link #303
pip install pyenv-win --target %USERPROFILE%\\.pyenv --no-user --upgrade
steps to add System Settings
Note: Don't forget the check above link, it contains final steps to complete.
Installation is complete!
This needs choco commands to install, installation link
Chocolatey command choco install pyenv-win
Chocolatey page: pyenv-win
Installation is complete!
Validate Installation
It's a easy way to use PowerShell here
[System.Environment]::SetEnvironmentVariable('PYENV',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_ROOT',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('PYENV_HOME',$env:USERPROFILE + "\.pyenv\pyenv-win\","User")
[System.Environment]::SetEnvironmentVariable('path', $env:USERPROFILE + "\.pyenv\pyenv-win\bin;" + $env:USERPROFILE + "\.pyenv\pyenv-win\shims;" + [System.Environment]::GetEnvironmentVariable('path', "User"),"User")
Installation is done. Hurray!
Using Git
cd %USERPROFILE%\.pyenvgit checkout -b 32bit-train origin/32bit-trainpyenv --version and you should see 2.32.xUsing pip
run pip install pyenv-win==2.32.x --target %USERPROFILE%\.pyenv
steps to add System Settings
Using Zip
Download pyenv-win.zip
Follow step 2 from Pyenv-win zip
steps to add System Settings
pyenv --versionpyenv to view it's usageIf you are getting "command not found" error, check the below note and manually check the settings
For Visual Studio Code or another IDE with a built in terminal, restart it and check again
Ensure all environment variables are properly set via the GUI:
This PC
→ Properties
→ Advanced system settings
→ Advanced → Environment Variables...
→ PATH
NOTE: If you are running Windows 10 1905 or newer, you might need to disable the built-in Python launcher via Start > "Manage App Execution Aliases" and turning off the "App Installer" aliases for Python
pyenv install -lpyenv install -l | findstr 3.8pyenv install 3.5.2
pyenv install 2.4.3 3.6.8pyenv global 3.5.2
pyenv local 3.5.2.
python is called from within this folder. This is different than a virtual env, which needs to be explicitly activated.pyenv rehash to update pyenv with new shims for the python and libraries' executables.
.pyenv folder.pyenv uninstall 3.5.2pyenv versionpyenv versionspyenv update command for pyenv-win 2.64.x and 2.32.x versionseasy_install.pth file located in site-packages. This should make pip recognise pyenv-win as installed.pip install --upgrade pyenv-win%USERPROFILE%\.pyenv\pyenv-win (which is your installed path) and run git pull%USERPROFILE%\.pyenv\pyenv-win and replace the folders libexec and bin with the new ones you just downloaded&"${env:PYENV_HOME}\install-pyenv-win.ps1"==================
To keep in sync with pyenv linux/mac, pyenv-win now installs 64bit versions by default. To support compatibility with older versions of pyenv-win, we maintain a 32bit train (branch) as a separate release.
Both releases can install 64bit and 32bit python versions; the difference is in version names, for example:
> pyenv install -l | findstr 3.8
....
3.8.0-win32
3.8.0
3.8.1rc1-win32
3.8.1rc1
3.8.1-win32
3.8.1
3.8.2-win32
3.8.2
3.9.0-win32
3.9.0
....
>pyenv install -l | findstr 3.8
....
3.8.0
3.8.0-amd64
3.8.1rc1
3.8.1rc1-amd64
3.8.1
3.8.1-amd64
3.8.2
3.8.2-amd64
....
==================
Support for Python versions below 2.4 have been dropped since their installers don't install "cleanly" like versions from 2.4 onward and they're predominantly out of use/support in most environments now.
==================
Question: Does pyenv for windows support python2?
Question: Does pyenv for windows support python3?
Question: I am getting the issue batch file cannot be found. while installing python, what should I do?
pyenv rehash command before creating the bat file on some devices.Question: System is stuck while uninstalling a python version
%USERPROFILE%\.pyenv\pyenv-win\versions), and delete the folder of the version you want removed.Question: I installed pyenv-win using pip. How can I uninstall it?
pip uninstall pyenv-winQuestion: pyenv-win is not recognised, but I have set the ENV PATH?
Add or remove Programs systems settings page before running the pyenv uninstall command for those versions.pyenv global and pyenv local no longer affect PYENV_VERSION, which only pyenv shell should affect.powershell and pwsh in addition to cmd.pyenv shell now works like pyenv global and pyenv local in that, on 32-bit platforms, it adds -win32 to every supplied version if not explicitly added.pyenv path.exec preferring the last version listed in .python-version instead of the first.
pyenv rehash must be called after upgrading. Expect the following error message if you don't:
'Scripts' is not recognized as an internal or external command,
operable program or batch file.
PATH in pyenv version to report other Python versions.exec shims for bat files.pyenv shellpyenv --version for username with space.pyenv exec.pyenv which and pyenv whence show help if no argument specified.pyenv exec.rehash error when no version installed.exec.bat to support multiple exec in parallel.exec.bat.pyenv global --unset.pyenv install 2.7.17 will install as 64-bit on x64 and 32-bit on x86. (64-bit can still use 2.7.17-win32 to install the 32-bit version)pyenv global/local/shell also now recognize your platform and select the appropriate bit version. (64-bit users will need to specify [version]-win32 to use the 32-bit versions now)pyenv uninstall)-a/--all switch.
--all on x64 computers you can use --32only or --64only to install only 32-bit or only 64-bit version s of python. (Does nothing on 32-bit computers, and better filters may be in the works later on)pyenv global/rehash is called automatically after (un)installing a new Python version. (last version specified, if installing multiple)pyenv update. Users no longer have to wait for pyenv's source repo to be updated to use a new version of Python when it releases, and can also use the new alpha/beta python releases.pyenv install now has a -c/--clear to empty cached installers in the %PYENV%\install_cache folder.pyenv rehash now acknowledges %PATHEXT% (plus PY and PYW) when creating shims instead of just for exe, bat, cmd and py files so more executables are available from \Scripts and libraries installed using pip.pyenv rehash no longer call pyenv exec, but instead call python directly to prevent issues with other programs executing the shims.tests\bat_files\test_install.bat and tests\bat_files\test_uninstall.batpyenv-win is licensed under MIT 2019
pyenv-win was developed by Kiran Kumar Kotari and Contributors
Thanks for all Contributors and Supports for patience for the latest major release.
FAQs
pyenv lets you easily switch between multiple versions of Python. It's simple, unobtrusive, and follows the UNIX tradition of single-purpose tools that do one thing well.
We found that pyenv-win demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 3 open source maintainers collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
Research
The Socket Research Team breaks down a malicious wrapper package that uses obfuscation to harvest credentials and exfiltrate sensitive data.
Research
Security News
Attackers used a malicious npm package typosquatting a popular ESLint plugin to steal sensitive data, execute commands, and exploit developer systems.
Security News
The Ultralytics' PyPI Package was compromised four times in one weekend through GitHub Actions cache poisoning and failure to rotate previously compromised API tokens.