Switch branches/tags
Find file Copy path
2f60e99 Jun 26, 2018
2 contributors

Users who have contributed to this file

@giampaolo @jdufresne
164 lines (102 sloc) 3.66 KB

Install pip

pip is the easiest way to install psutil. It is shipped by default with Python 2.7.9+ and 3.4+. For other Python versions you can install it manually. On Linux or via wget:

wget -O - | python

On macOS or via curl:

python < <(curl -s

On Windows, download pip, open cmd.exe and install it:


Permission issues (UNIX)

The commands below assume you're running as root. If you're not or you bump into permission errors you can either:

  • prepend sudo, e.g.:
sudo pip install psutil
  • install psutil for your user only (not at system level):
pip install --user psutil


Ubuntu / Debian:

sudo apt-get install gcc python-dev python-pip
pip install psutil

RedHat / CentOS:

sudo yum install gcc python-devel python-pip
pip install psutil

If you're on Python 3 use python3-dev and python3-pip instead.


Install Xcode first, then:

pip install psutil


The easiest way to install psutil on Windows is to just use the pre-compiled exe/wheel installers hosted on PYPI via pip:

C:\Python27\python.exe -m pip install psutil

If you want to compile psutil from sources you'll need Visual Studio (Mingw32 is no longer supported), which really is a mess. The VS versions are the onle listed below. This blog post provides numerous info on how to properly set up VS (good luck with that).

Compiling 64 bit versions of Python 2.6 and 2.7 with VS 2008 requires Windows SDK and .NET Framework 3.5 SP1. Once installed run vcvars64.bat, then you can finally compile (see here). To compile / install psutil from sources on Windows run:

make.bat build
make.bat install


pkg install python gcc
python -m pip install psutil


export PKG_PATH="`uname -r`/packages/`arch -s`/"
pkg_add -v python gcc
python -m pip install psutil


export PKG_PATH="`uname -m`/`uname -r`/All"
pkg_add -v pkgin
pkgin install python gcc
python -m pip install psutil


If cc compiler is not installed create a symlink to gcc:

sudo ln -s /usr/bin/gcc /usr/local/bin/cc


pkg install gcc
python -m pip install psutil

Install from sources

git clone
cd psutil
python install

Dev Guide

If you plan on hacking on psutil you may want to take a look at the dev guide.