Wrapper to expose Kinect for Windows v2 API in Python
Switch branches/tags
Nothing to show
Clone or download
vladkol Merge pull request #33 from mspraggs/master
Added code to facilitate use with 32 and 64 bit numpy
Latest commit c86d575 Sep 28, 2016



Enables writing Kinect applications, games, and experiences using Python. Inspired by the original PyKinect project on CodePlex.

Only color, depth, body and body index frames are supported in this version. PyKinectBodyGame is a sample game. It demonstrates how to use Kinect color and body frames.


The easiest way to get most of the pre-requisites is to use Anaconda which includes NumPy. You'll then need to pip install comtypes. The PyKinectBodyGame sample requires PyGame which needs to be manually installed.

  1. Download Anaconda get the 32-bit version. This includes NumPy.
  2. pip install comtypes
  3. Install the Kinect for Windows SDK v2

Full List of Dependencies


The package can be installed through pip using the usual means:

pip install pykinect2

If you are using a virtual environment, be sure to activate it first.

For more information, please see https://pip.pypa.io/en/latest/user_guide.html#installing-packages

Installation (Manual)

To install the package manually, clone this repository to a local folder and include it in the appropriate python environment. If installing in a virtual environment, be sure to install all required dependencies (above).

For example:

cd c:\projects\myproject\env\

easy_install -a c:\projects\downloads\PyKinect2

After installation is complete, you can launch the interactive python shell and import pykinect2 to ensure everything has been installed properly.

Core helper classes for working with the Kinect sensor are located in PyKinectRuntime.py. For usage examples, please see /examples/PyKinectBodyGame.py.