Azure-Kinect-Python

Python 3 bindings for the Azure Kinect SDK

Changelog

• v1.1.0: Updated supported SDK and firmware versions to latest
• v1.0.0: Initial release

Setup

Install the right Kinect SDK, Kinect Body Tracking SDK, and device firmware versions

Please uninstall all unrelated SDK versions if you are having issues. The supported versions are:

• Sensor SDK v1.4.1
• Body tracking SDK v1.0.1
• Device firmware version must be at least 1.6.110079014 or higher.

Add the following to your system PATH:

• C:\Program Files\Azure Kinect SDK v1.4.1\sdk\windows-desktop\amd64\release\bin
• C:\Program Files\Azure Kinect Body Tracking SDK\sdk\windows-desktop\amd64\release\bin
• C:\Program Files\Azure Kinect Body Tracking SDK\tools

(Or relevant paths for your platform containing the the k4a(.so|.dll) and k4abt(.so|.dll) dynamic libraries)

Feature support

Currently only body tracking is wrapped, but adding further wrappings should be easy and PRs would be appreciated!

Examples

There is a very simple example you can run via:

py -3 example/simple_sample.py

Demos

We are using it to develop an Azure Kinect plugin for Blender, which you can see a very early demo of here:

The plugin is available for early access and will be open-sourced soon, please email stephen@hexops.com to gain early access.

Troubleshooting

Do NOT use Python from the Windows Store

If you get the error:

[2021-01-18 14:05:28.307] [error] [t=6336] [K4ABT] D:\a\1\s\src\TrackerHost\TrackerHost.cpp (157): Create(). Find onnxruntime.dll at C:\Program Files\Azure Kinect Body Tracking SDK\tools\onnxruntime.dll but it doesn't load correctly!

It is because the Windows Store installs Python to a restricted user directory which cannot access external DLLs.