.. _python-install-guide:

Python SDK Install Guide
========================

Installing the SDK
------------------

Windows
+++++++

1.  Make sure to download **Python 2.7 32 bits**,
2.  Run the installer.

Mac
+++

1. Choose between these 2 options:

* Use the ``Python 2.6`` that comes by default with MacOS, with the ``python-2.6`` SDK.

* Or, install ``Python 2.7 32/64 bits`` from Python.org. You can find the installer here:
  http://python.org/download/

2. Set the environnement variable ``PYTHONPATH`` to ``/path/to/python-sdk``

Linux
+++++

1. Choose between these 2 options:

* If you are running Ubuntu Lucid to Maverick, use the ``python-2.6`` package,
* for Ubuntu Natty and later, use the ``python-2.7`` packages

2. Set the environnement variable ``PYTHONPATH`` to ``/path/to/python-sdk``

Checking the installation of the Python SDK
--------------------------------------------

Windows
+++++++

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

Mac
+++

If you choose to use the Python2.7 from python.org:

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

2. Try to run:

.. code-block:: python

  import naoqi


Linux
+++++

Simply run:

.. code-block:: python

  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 :ref:`python-sdk-troubleshooting` section


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.