Skip to content
Go to file
2 contributors

Users who have contributed to this file

@giampaolo @jdufresne
140 lines (90 sloc) 3.2 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 aren't or you bump into permission errors you can either install psutil for your user only:

pip3 install --user psutil

...or prepend sudo and install it globally, e.g.:

sudo pip3 install psutil


Ubuntu / Debian:

sudo apt-get install gcc python3-dev
pip3 install psutil

RedHat / CentOS:

sudo yum install gcc python3-devel
pip3 install psutil

If you're on Python 2 use python-dev instead.


Install Xcode then run:

pip3 install psutil


Open a cmd.exe shell and run:

python3 -m pip install psutil

This assumes "python" is in your PATH. If not, specify the full python.exe path.

In order to compile psutil from sources you'll need Visual Studio (Mingw32 is not supported). This blog post provides numerous info on how to properly set up VS. The needed VS versions are:

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 (see here). Once VS is setup open a cmd.exe shell, cd into psutil directory and run:

python3 build
python3 install


pkg install python3 gcc
python -m pip3 install psutil


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


export PKG_PATH="`uname -m`/`uname -r`/All"
pkg_add -v pkgin
pkgin install python3 gcc
python3 -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
python3 -m pip install psutil

Install from sources

git clone
cd psutil
python3 install

Testing installation

python3 -m psutil.tests

Dev Guide

See: dev guide.

You can’t perform that action at this time.