Installing ActivePython on Windows
You can install ActivePython by downloading and running the Setup Wizard (.msi). For more complex installations you can run the Setup Wizard on the command line. If you do not have Administrator rights on the computer, you can use the generic ActiveState Package Installer to complete the installation.
ActivePython requires Windows XP, or later.
Before you begin
- Other Python 2.7 Installations: ActivePython 2.7 cannot coexist with other Python 2.7 installations on Windows. You must uninstall any other Python 2.7 installations, such as a Python 2.7 build from python.org, before installing ActivePython 2.7.
- Directory name: You should install ActivePython in a directory that does not contain spaces in the name. Spaces can causes problems on some versions of Windows with certain service pack levels. By default ActivePython installs to a directory without spaces.
- Directory contents: If you are installing ActivePython to an existing directory, the ActivePython setup wizard may overwrite files in that directory. We recommend that you install ActivePython in a new or empty directory.
If you have problems importing certain modules after installation, please verify that your system meets the criteria listed above before submitting a bug report.
Using the ActivePython Setup Wizard
There are two ways to install ActivePython with the setup wizard:
- You can run the setup wizard and enter the required information to install the software.
- If you want to automate the installation, you can run the setup wizard from the command line.
Running the ActivePython Setup Wizard
When you install ActivePython, you should run the setup wizard as an Administrator.
- Download and save the
- Right-click the .msi file and select Run As Administrator.
- Follow the prompts on screen to complete the installation.
Running the installation as an Administrator allows other users on the computer to use ActivePython, and ensures that all of ActivePython’s features function correctly. Installing ActivePython without administrative privileges has the following limitations:
- The Python ActiveX scripting engine feature will be unavailable.
- Windows NT/2000 users will not be able to write Services.
- Environment variables cannot be set (e.g. PATH, PATHEXT).
- File associations for Python files cannot be set.
- Any registry entries created are under
HKEY_CURRENT_USERand not under
See the Getting started with ActivePython on Windows for a general introduction to ActivePython on your platform, and pointers to documentation that will be most useful to you.
Running the ActivePython Setup Wizard on the command line
You can install the ActivePython MSI from the command line. You should start the command prompt as an Administrator to ensure the the installation can complete successfully.
c:\> msiexec.exe /i ActivePython-<version>.msi
ActivePython’s installer uses Windows Installer technology. This allows you to partially control the install from the command line.
You can generate a log of the ActivePython installation with the following command. The following command will generate a log of the install in “install.log”.
c:\> msiexec.exe /i ActivePython-<version>.msi /L*v install.log
Specifying the installation directory
Command line options can be used to configure ActivePython installation
properties. For example, the following will install ActivePython to
D:\myapps\Python, instead of the default:
c:\> msiexec.exe /i ActivePython-<version>.msi APPDIR=D:\myapps\Python
Specifying the features to install
ActivePython is divided into features. In the “Customize Setup” dialog you can select which features to install. You can also do this on the command line with the ADDLOCAL property. For example, the following command will install just the core ActivePython functionality (i.e. not the PyWin32 extensions or the documentation.
c:\> msiexec.exe /i ActivePython-<version>.msi ADDLOCAL=core
The current set of ActivePython setup wizard features are:
core ActivePython core (must be installed) doc Documentation
Where the hierarchy denotes dependencies you must install them. For example, to install
doc you must install the ActivePython core (
These command line options can all be brought together. For example, the
following command will install just the ActivePython core and
c:\> msiexec /i ActivePython-<version>.msi /qn+ INSTALLDIR=C:\myapps\Python ADDLOCAL=core
For more information in the command line installation options, contact firstname.lastname@example.org
Uninstalling the MSI
The ActivePython for Windows can be uninstalled using the Modify, Repair or Uninstall ActivePython shortcut in the ActiveState ActivePython 2.7 program group in the Windows Start menu. Alternatively, you may uninstall the ActivePython MSI from Add/Remove Programs in the Control Panel.
Alternatively, you use the setup wizard file to uninstall ActivePython from the command line and write the progress to a log file:
c:\> msiexec.exe /uninstall ActivePython-<version>.msi /L*v uninstall.log
ActiveState package installer
You can alternatively use the ActiveState package installer it to install ActivePython if you do not have Administrator rights on Windows.
- Download the package to a temporary directory, extract the files, and run the
The AS package is delivered as a zip file, (
To install interactively, simple run the install script without arguments. The install script will prompt your for an installation directory.
or equivalent and:
C:\> cd .../ActivePython-<version> C:\...\ActivePython-<version>> install.bat
You can add the bin directory to your PATH environment variable for quicker access.
By default the install script will prompt you for an install directory.
You can avoid this interaction by specifying the install directory with
-I <installdir> option. Use the
-h option for full usage information.
Uninstalling the “AS Package”
Uninstalling an “AS Package” installation is as simple as removing the directory to which you installed, because the ActivePython installation is fully contained in that install location.