(updated March 26, 2015 to remove misleading setuptools instruction )
You can install additional packages (either external or from the Canopy / EPD repository) into Canopy User Python in a Windows command prompt window or Mac/Linux terminal window.
The key point is that you must install into the Canopy User Python environment, not into Canopy's Core or System Python environments.
1. Be sure that you have updated to Canopy 1.2 or higher (using the Canopy help menu). We recommend using the latest available version.
2. Ensure that Canopy User Python is on the shell PATH, i.e. that typing `python` at the prompt starts Canopy User Python, not another python.
The easiest way to ensure this is to work in a Canopy Command Prompt (Windows) or a Canopy Terminal (Mac or Linux), available from the Canopy Tools menu in Canopy 1.4 and above.
Otherwise, see this article for details on setting PATH, and see this article for more information about the difference between Canopy User Python and other Canopy Pythons, which you should not use directly.
3. If you are using Canopy 1.3 in Windows, please update to Canopy 1.4 or higher.
4. To install a package which is not available in the Canopy / EPD repository, follow standard Python installation procedures from the OS command line.
Caution: Do not install setuptools in EPD or Canopy. Setuptools 0.6 is already supported, and higher versions are not yet compatible with Enthought installers. EPD / Canopy includes distribute 0.6.26, which simulates setuptools 0.6. If you install setuptools, then you will corrupt distribute and have problems. If you need to install a package which requires a version of setuptools greater than 0.6, please email us at firstname.lastname@example.org, explaining your needs and we will provide a solution if feasible. We will be building a new version of distribute which provides the necessary functionality.
5. If you are not installing a new package, but updating one that is already in Canopy to a version that is not yet available in our repository, please note this article.
6. With the PATH set as just described, you may also use the EPD/Canopy `enpkg` utility from the OS command line, in lieu of the Canopy package manager.
7. (Windows only) - binary package installers such as Chris Gohlke's work, provided that you have made Canopy your default Python from the Canopy preferences menu.
Packages installed using these non-Enthought installers will not be listed in the Package Manager, but they will be fully installed into, and usable in, Enthought Canopy User Python. We are reviewing options for listing them in the Package Manager in future versions of Canopy.
Listing both Canopy-installed and externally-installed packages
To see a list of all the packages installed by normal means into Canopy User Python, whether by Package Manager, enpkg, egginst, pip, or easy_install, you can type the following at a Canopy Command Prompt / Terminal:
Windows only: using binary package installers such as those by Chris Gohlke
1. Make Canopy your default Python from the Canopy preferences dialog (in the Canopy Edit menu). Note that it is not sufficient to modify your PATH, or open a Canopy Command Prompt window.
2. Find and download the installer version which matches your Canopy install (32/64-bits), and is the package version that you want.
For Chris Gohlke's installers, the download page is http://www.lfd.uci.edu/~gohlke/pythonlibs/
3. Run the downloaded installer.
4. You should now be able to use that package in Canopy.
Please do not enter support requests in article comments
Please use article comments for suggestions to improve the article. For individual support requests, please follow these guidelines.