# SoftBank Robotics documentation What's new in NAOqi 2.8?

# Python SDK - Installation Guide

## Supported Operating Systems

OS | Version
--- | ---
Linux | Ubuntu 16.04 Xenial Xerus - 64bits only
Windows | Microsoft Windows 10 64bits
Mac | Mac OS X 10.12 Sierra

## Installing the SDK

### Windows

Step | Action
--- | ---
| Python Make sure to download Python 2.7. You can find the installer here: http://python.org/download/
| NAOqi for Python Extract: `pynaoqi-python2.7-2.8.x.x-win64-vs2015-xxxxx.zip` You can download the latest release from Developer Center 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 Developer Center 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 Developer Center 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.

Glossary Site map Index Support Contact Legal Notices