Skip to content

Latest commit

 

History

History
116 lines (75 loc) · 3.17 KB

INSTALL.rst

File metadata and controls

116 lines (75 loc) · 3.17 KB
Raw

Installing using pip on UNIX

The easiest way to install psutil on UNIX is by using pip (but first you might need to install python header files; see later). First install pip:

$ wget https://bootstrap.pypa.io/get-pip.py
$ python get-pip.py

...then run:

$ pip install psutil

You may need to install gcc and python header files first (see later).

Installing on Windows

Just get the right installer for your Python version and architecture from: https://pypi.python.org/pypi/psutil/#downloads Since wheels installers are also available you may also use pip.

Compiling on Windows using Visual Studio

In order to compile psutil on Windows you'll need Visual Studio (Mingw32 is no longer supported). You must have the same version of Visual Studio used to compile your installation of Python, that is:

* Python 2.6:  VS 2008 (download it from `here <http://www.microsoft.com/en-us/download/details.aspx?id=44266>`_)
* Python 2.7:  VS 2008 (download it from `here <http://www.microsoft.com/en-us/download/details.aspx?id=44266>`_)
* Python 3.3, 3.4: VS 2010 (you can download it from `MS website <http://www.visualstudio.com/downloads/download-visual-studio-vs#d-2010-express>`_)
* Python 3.5: `VS 2015 UP <http://www.visualstudio.com/en-au/news/vs2015-preview-vs>`_

...then run:

setup.py build

...or:

make.bat build

Compiling 64 bit versions of Python 2.6 and 2.7 with VS 2008 requires Windows SDK and .NET Framework 3.5 SP1 to be installed first. Once you have those run vcvars64.bat, then compile: http://stackoverflow.com/questions/11072521/

Installing on Linux

gcc is required and so the python headers. They can easily be installed by using the distro package manager. For example, on Debian and Ubuntu:

$ sudo apt-get install gcc python-dev

...on Redhat and CentOS:

$ sudo yum install gcc python-devel

Once done, you can build/install psutil with:

$ python setup.py install

Installing on OS X

OS X installation from source will require gcc which you can obtain as part of the 'XcodeTools' installer from Apple. Then you can run the standard distutils commands. To build only:

$ python setup.py build

To install and build:

$ python setup.py install

Installing on FreeBSD

The same compiler used to install Python must be present on the system in order to build modules using distutils. Assuming it is installed, you can build using the standard distutils commands.

Build only:

$ python setup.py build

Install and build:

$ python setup.py install

Makefile

A makefile is available for both UNIX and Windows (make.bat). It provides some automations for the tasks described above and might be preferred over using setup.py. With it you can:

$ make install    # just install (in --user mode)
$ make uninstall  # uninstall (needs pip)
$ make test       # run tests
$ make clean      # remove installation files