SoftBank Robotics documentation What's new in NAOqi 2.5?

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.11 El Capitan

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.5.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

Mac

Step Action

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 environment variables PYTHONPATH and DYLD_LIBRARY_PATH to /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

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 environment variable PYTHONPATH to /path/to/python-sdk/lib/python2.7/site-packages

By doing for example:

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

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.