stonebig edited this page Sep 3, 2018 · 14 revisions


As some packages were built using Microsoft Visual Studio, you may have to install one of the following redistribution packages for WinPython 2.7 only:


As WinPython is a portable distribution, the installer only copies compressed files to the specified destination directory. To install in terms of register your distribution in the system, see the section Registration on this page.


All installed Python packages store their settings in [WINPYTHON_DIR]\settings instead of a user profile directory (e.g. C:\Users\username), hence allowing to move your settings with your favorite distribution, in a portable way. This is the default behavior but it can be changed by simply removing the [WINPYTHON_DIR]\settings folder, forcing WinPython to use the user profile directory instead.


The WinPython Control Panel allows to register your WinPython distribution to Windows.

Winpython Control Panel>Advanced>Register distribution

Registering your WinPython installation will:

  • associate file extensions .py, .pyc and .pyo to Python interpreter
  • register Python icons in Windows explorer
  • add context menu entries Edit with IDLE and Edit with Spyder for .py files
  • register WinPython as a standard Python distribution in the registry (the same way as the standard Python Windows installers will do)

connecting to VS Code

see VSCode page


According to statement there is no way to unregister, i.e. unassociate file extensions .py, .pyc and .pyo :

Register distribution This will associate file extensions, icons and Windows explorer's context menu entries ('Edit with IDLE', ...) with selected Python distribution in Windows registry.
Shortcuts for all WinPython launchers will be installed in WinPython Start menu group (replacing existing shortcuts).
If pywin32 is installed (it should be on any WinPython distribution), the Python ActiveX Scripting client will also be registered.

Warning: the only way to undo this change is to register another Python distribution to Windows registry.

Note: these actions are exactly the same as those performed when installing Python with the official installer for Windows.

Do you want to continue? &Yes &No

Operating Systems

Windows Vista, 7, 8 and 10

WinPython works fine in Windows 7, 8 and 10 just by extracting it to your favorite place.

Older systems like Windows Server 2003, Windows XP and Windows Vista are not no longer supported. You may are able to run your programs, but IPython (and thus Spyder) is defintely broken, unless you apply the workaround described in the next section. As we don't test our releases on these platforms we cannot guarantee incompatibilites and unexpected behavior.

Windows XP

Windows XP is not supported by Winpython and we don't recommend to run it nevertheless. If you really need to use Winpython on XP, you will get errors like OSError: [WinError 127]" and a Procedure not found at the end of the backtraces. This comes from the zmq library which depends on a DLL not existing in XP. There's a workaround described in #17:

Transplant the working zmq lib. I took the current WinPython-3.3.5 installation, deleted the contents of "python-3.3.5\Lib\site-packages\zmq" and replaced it with the files of the same directory from WinPython 4.2013. Everything works a treat now...

You can’t perform that action at this time.
You signed in with another tab or window. Reload to refresh your session. You signed out in another tab or window. Reload to refresh your session.
Press h to open a hovercard with more details.