I’m having trouble installing a Python package on my Windows machine, and would like to install it with Christoph Gohlke’s Window binaries. (Which, to my experience, alleviated much of the fuss for many other package installations). However, only .whl files are available.
But how do I install .whl files?
I just used the following which was quite simple. First open a console then cd to where you’ve downloaded your file like some-package.whl and use
pip install some-package.whl
Note: if pip.exe is not recognized, you may find it in the “Scripts” directory from where python has been installed. If pip is not installed, this page can help:
How do I install pip on Windows?
Note: for clarification
If you copy the
*.whl file to your local drive (ex. C:some-dirsome-file.whl) use the following command line parameters —
pip install C:/some-dir/some-file.whl
First, make sure you have updated pip to enable wheel support:
pip install --upgrade pip
Then, to install from wheel, give it the directory where the wheel is downloaded. For example, to install
pip install --use-wheel --no-index --find-links=/where/its/downloaded package_name
There are several file versions on the great Christoph Gohlke’s site.
Something I have found important when installing wheels from this site is to first run this from the Python console:
import pip print(pip.pep425tags.get_supported())
so that you know which version you should install for your computer. Picking the wrong version may fail the installing of the package (especially if you don’t use the right CPython tag, for example, cp27).
I am in the same boat as the OP.
Using a Windows command prompt, from directory:
C:Python34Scripts> pip install wheel
seemed to work.
Changing directory to where the whl was located, it just tells me ‘pip is not recognized’. Going back to
C:Python34Scripts>, then using the full command above to provide the ‘where/its/downloaded’ location, it says
Requirement 'scikit_image-...-win32.whl' looks like a filename, but the filename does not exist.
So I dropped a copy of the .whl in Python34/Scripts, ran the exact same command over again (with the
--find-links= still going to the other folder), and this time it worked.
You have to run pip.exe from the command prompt on my computer.
C:/Python27/Scripts/pip2.exe install numpy
On Windows you can’t just upgrade using
pip install --upgrade pip, because the
pip.exe is in use and there would be an error replacing it. Instead, you should upgrade
pip like this:
easy_install --upgrade pip
Then check the
If it shows
6.x series, there is wheel support.
Only then, you can install a wheel package like this:
pip install your-package.whl
To be able to install wheel files with a simple doubleclick on them you can do one the following:
1) Run two commands in command line under administrator privileges:
assoc .whl=pythonwheel ftype pythonwheel=cmd /c pip.exe install "%1" ^& pause
2) Alternatively, they can be copied into a
wheel.bat file and executed with ‘Run as administrator’ checkbox in the properties.
PS pip.exe is assumed to be in the PATH.
(1) Those can be combined in one line:
assoc .whl=pythonwheel& ftype pythonwheel=cmd /c pip.exe install -U "%1" ^& pause
(2) Syntax for .bat files is slightly different:
assoc .whl=pythonwheel& ftype pythonwheel=cmd /c pip.exe install -U "%%1" ^& pause
Also its output can be made more verbose:
see my blog post for details.
EDIT: THIS NO LONGER IS A PART OF PIP
To avoid having to download such files, you can try:
pip install --use-wheel pillow
For more information, see this.
You can install the .whl file, using
pip install filename. Though to use it in this form, it should be in the same directory as your command line, otherwise specify the complete filename, along with its address like
pip install C:SomePAthfilename.
Also make sure the .whl file is of the same platform as you are using, do a
python -V to find out which version of Python you are running and if it is win32 or 64, install the correct version according to it.
In-case if you unable to install specific package directly using PIP.
You can download a specific
.whl (wheel) package from – https://www.lfd.uci.edu/~gohlke/pythonlibs/
CD (Change directory) to that downloaded package and install it manually by –
pip install PACKAGENAME.whl
pip install ad3?2.1?cp27?cp27m?win32.whl
The only way I managed to install NumPy was as follows:
I downloaded NumPy from here
Command execution from Python’s installation path in PowerShell
PS C:Program Files (x86)Python35-32> .python -m pip install C:/Users/MyUsername/Documents/Programs/Python/numpy-1.11.2-cp35-none-win32.whl Processing c:usersMyUsernamedocumentsprogramsnumpy-1.11.2-cp35-none-win32.whl Installing collected packages: numpy Successfully installed numpy-1.11.2 PS C:Program Files (x86)Python35-32>
PS.: I installed it on Windows 10.
What I did was first updating the pip by using the command:
pip install --upgrade pip and then I also installed wheel by using command:
pip install wheel and then it worked perfectly Fine.
Hope it works for you I guess.
New Python users on Windows often forget to add Python’s Scripts directory to the PATH variable during the installation. I recommend to use the Python launcher and execute pip as a script with the
-m switch. Then you can install the wheels for a specific Python version (if more than one are installed) and the Scripts directory doesn’t have to be in the PATH. So open the command line, navigate (with the
cd command) to the folder where the .whl file is located and enter:
py -3.6 -m pip install your_whl_file.whl
3.6 by your Python version or just enter
-3 if the desired Python version appears first in the PATH. And with an active virtual environment:
py -m pip install your_whl_file.whl.
Of course you can also install packages from PyPI in this way, e.g.
py -3.6 -m pip install pygame
I would be suggesting you the exact way how to install .whl file.
Initially I faced many issues but then I solved it, Here is my trick to install .whl files.
Follow The Steps properly in order to get a module imported
- Make sure your .whl file is kept in the python 2.7/3.6/3.7/.. folder.
Initially when you download the .whl file the file is kept in downloaded folder, my
suggestion is to change the folder. It makes it easier to install the file.
- Open command prompt and open the folder where you have kept the file by entering
cd c:python 3.7
3.Now, enter the command written below
>py -3.7(version name) -m pip install (file name).whl
Click enter and make sure you enter the version you are currently using with correct
Once you press enter, wait for few minutes and the file will be installed and you will
be able to import the particular module.
In order to check if the module is installed successfully, import the module in idle
and check it.
Download the package (.whl).
Put the file inside the script folder of python directory
Use the command prompt to install the package.
C:Python36Scripts>pip install package_name.whl
There’s a slight difference between accessing the .whl file in python2 and python3.In python3 you need to install wheel first and then you can access .whl files.
pip install wheel
And then by using wheel
wheel unpack some-package.whl
pip install some-package.whl
On the MacOS, with
pip installed via MacPorts into the MacPorts python2.7, I had to use @Dunes solution:
sudo python -m pip install some-package.whl
python was replaced by the MacPorts python in my case, which is
python3.5 for me.
-m option is “Run library module as script” according to the manpage.
(I had previously run
sudo port install py27-pip py27-wheel to install
wheel into my python 2.7 installation first.)