Metadata-Version: 2.4
Name: idiap_robot_toolkit
Version: 0.6.2
Summary: Idiap's Robot Toolkit
Author-email: Olivier Canévet <olivier.canevet@idiap.ch>
License: For the documentation: see LICENSES/CC-BY-SA-4.0.txt
        
        For the code: see LICENSES/MIT.txt
        
Classifier: Development Status :: 4 - Beta
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.7
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: Python :: 3.9
Classifier: Programming Language :: Python :: 3.10
Classifier: Programming Language :: Python :: 3.11
Classifier: Operating System :: Unix
Requires-Python: >=3.7
Description-Content-Type: text/markdown
License-File: LICENSE
Requires-Dist: PySide6
Requires-Dist: loguru
Requires-Dist: numpy
Requires-Dist: opencv-python
Requires-Dist: pyyaml
Requires-Dist: qi
Requires-Dist: qtpy
Dynamic: license-file

<!--
    SPDX-FileCopyrightText: 2025-2026 Idiap Research Institute <contact@idiap.ch>
    SPDX-FileContributor: Olivier Canévet <olivier.canevet@idiap.ch>
    SPDX-License-Identifier: CC-BY-SA-4.0
-->

<img src="./docs/assets/images/banner.jpg" alt="" width="100%"/>

# Idiap Robot Toolkit

A toolkit to handle robots with Python.

## Installation

The Idiap Robot Toolkit is available on [PyPi](https://pypi.org/project/idiap-robot-toolkit)
and can be installed via `pip`:

```bash
$ pip install idiap-robot-toolkit
```

When using Qt6 through PySide6, install it with conda:

```bash
(base) $ conda create -y -n irt python=3.11 pip pyside6
(base) $ conda activate irt
(irt) $ pip install idiap-robot-toolkit
# or
(irt) $ pip install -e .
```

## Using the Wizard-of-Oz GUI

The `qi_robot_wizard` executable launches a GUI to control Pepper.

```bash
qi_robot_wizard --robot pepper --name myapp --scenario resources/yes-no.ini --tablet resources/images/
```

with for instance the following `resources/yes-no.ini` file

```
[yes]

yes: Yes, indeed!
definitely: Definitely yes!
sure: Yes, for sure!

[no]

afraid: I am afraid not!
impossible: Unfortunately, that won't be possible
no: Absolutely not.
```

and the following images (which will be copied on the robot to `/home/nao/.local/share/PackageManager/apps/myapp/html`)

```
pepper-images/
├── black.png
├── green.png
├── idiap-1600.png
└── mummer-logo.png
```

renders the following GUI

![GUI of the Wizard-of-Oz](https://raw.github.com/idiap/idiap-robot-toolkit/7575fbc4f9a733ce0733e9b122ddc28405f67a2f/docs/assets/images/wizard.jpg)

## Using the API

Folder [examples](https://github.com/idiap/idiap-robot-toolkit/tree/7575fbc4f9a733ce0733e9b122ddc28405f67a2f/examples) contains some Python scripts  on how to
use the toolkit.

```python
# NAO_IP being defined as en env variable
robot = irt.Pepper()
robot.wake_up()
robot.say("Hello! I am Pepper.")
_, frame = robot.get_frame()
```
