SoftBank Robotics documentation What's new in NAOqi 2.8?

Python SDK - Installation Guide

Supported Operating Systems

OS Version
Linux Ubuntu 14.04 Trusty Tahr - 64bits only
Windows Microsoft Windows 7 and 8.1
Mac Mac OS X 10.12 Sierra

Installing the SDK

Windows

Step Action

Python

Make sure to download Python 2.7 - 32 bits.

You can find the installer here: http://python.org/download/

NAOqi for Python

Extract: pynaoqi-python2.7-2.8.x.x-win32-vs2013.zip

You can download the latest release from SoftBank Robotics Community website. For further details, see: Downloading & Installing SoftBank Robotics Software.

Set the following environment variables:

Environment variable Value
PYTHONPATH path\to\python-sdk\lib

Windows 7

From the Desktop, right-click the Computer icon and select Properties. If you don’t have a Computer icon on your desktop, click the Start button, right-click the Computer option in the Start menu, and select Properties.

Windows 8

From the Desktop, right-click the very bottom left corner of the screen and click System.

Click the Advanced System Settings link in the left column.
In the System Properties window, click on the Advanced tab, then click the Environment Variables button near the bottom of that tab.

In the Environment Variables window, add a new User variable:

PYTHONPATH

and set it to:

path\to\python-sdk\lib

Download and install the “Microsoft Visual C++ 2010 Redistributable Package (x86)”.

(You can skip this step if you have already installed Choregraphe.)

Mac

Step Action

Make sure the System Integrity Protection is disabled.

For further details, see: [Apple] Configuring System Integrity Protection.

Python

  • Install Python 2.7 from Python.org
  • Make sure to use Python from /usr/local/bin/python, not /usr/bin/python

NAOqi for Python

Extract: pynaoqi-python-2.7-naoqi-x.x-mac64.tar.gz

You can download the latest release from SoftBank Robotics Community website. For further details, see: Downloading & Installing SoftBank Robotics Software.

Set the following environment variables:

Environment variable Value
PYTHONPATH /path/to/python-sdk/lib/python2.7/site-packages
DYLD_LIBRARY_PATH /path/to/python-sdk/lib
QI_SDK_PREFIX /path/to/python-sdk

By doing for example:

$ export PYTHONPATH=${PYTHONPATH}:/path/to/python-sdk/lib/python2.7/site-packages
$ export DYLD_LIBRARY_PATH=${DYLD_LIBRARY_PATH}:/path/to/python-sdk/lib
$ export QI_SDK_PREFIX=/path/to/python-sdk
Optionally, re-enable System Integrity Protection.

Linux

Step Action

Python

Make sure to install Python2.7. There are many distributions shipped with Python3 by default, so you should make sure to install the python2 package.

NAOqi for Python

Extract: pynaoqi-python-2.7-naoqi-x.x-linux32.tar.gz

You can download the latest release from SoftBank Robotics Community website. For further details, see: Downloading & Installing SoftBank Robotics Software.

Set the following environment variables:

Environment variable Value
PYTHONPATH /path/to/python-sdk/lib/python2.7/site-packages
QI_SDK_PREFIX /path/to/python-sdk

By doing for example:

$ export PYTHONPATH=${PYTHONPATH}:/path/to/python-sdk/lib/python2.7/site-packages
$ export QI_SDK_PREFIX=/path/to/python-sdk

Checking the installation of the Python SDK

Windows

Run the default IDE (IDLE) that comes with the python installer.

Mac

  1. Make sure to use /usr/local/bin/python

  2. Try to run:

    import naoqi
    

Linux

Simply run:

import naoqi

If you do not get any error message, congratulations ! You are now ready to use the Python SDK.

If you do get an error message, please see: Python SDK - Troubleshooting.

Note for previous 1.10 users

Previously, 1.10 users did not have a separate Python SDK and had to set PYTHONPATH to naoqi/sdk/lib.

This method will not work anymore, (unless you are very lucky), so please do use the new Python SDK.