.. _python-introduction:

Python SDK
==========

:ref:`Overview <sdk-index>` | :ref:`C++<cpp-introduction>` | Python |
:ref:`.Net <naoqi-dot-net>` | :ref:`Java <java>` | :ref:`Matlab <matlab>` | :ref:`Urbi <urbi>`

.. toctree::
  :hidden:

  install_guide
  tutorials
  examples
  tips-and-tricks

The Python API for NAO allows you to use all of the c++ API from a remote machine,
or create Python modules that can run remotely or on the robot. Using Python is
one of the easiest ways to program with NAO.

Please make sure to have read the :ref:`naoqi-overview` section first.

The basic approach is:

- Import ALProxy
- Create an ALproxy to the module you want to use
- Call a method

This can be seen in the following example, which is explored in detail in :ref:`python_making_nao_speak`.

.. code-block:: python

  from naoqi import ALProxy
  tts = ALProxy("ALTextToSpeech", "<IP of your robot>", 9559)
  tts.say("Hello, world!")

Installation
------------

Pleas read the :ref:`python-install-guide` section

Samples and tutorials
---------------------


A progressing series of tutorials is available in the
:ref:`python-tutorials` section.

See also the :ref:`python-examples` section.


Reference documentation
-----------------------

* :ref:`naoqi-python-api`