ilo is a powerful Python package to control ilo the new educational robot directly from your computer.
It allows you to move the robot, read sensors, interact with LEDs, and create autonomous behaviors — all in just a few lines of Python.

Features

• Move the robot in multiple directions with Python commands
• Create complex movement loops
• Draw and animate using the robot's LED matrix
• Play with the robot in real time using your keyboard
• Use colored cards to trigger autonomous modes
• Control and read sensors over Wi-Fi or Bluetooth

---

Installation

pip install ilo

To update:

pip install ilo --upgrade

---

Quick Example

Here is a simple example to get started:

import ilo
import time

ilo.check_robot_on_bluetooth()
# ilo.check_robot_on_wifi()  # Make sure you are connected to the robot's Wi-Fi AP

my_ilo = ilo.robot("my-robot")

# Go forward until an obstacle is close
while my_ilo.get_distance_front() > 30:
    my_ilo.move("front", 10, 50) 
    time.sleep(0.1)

my_ilo.stop()  # Stop the robot
my_ilo.step("rot_clock")  # Rotate clockwise
my_ilo.set_led_color(25, 200, 25)
my_ilo.step("front", 0.5)

---

Dependencies

All dependencies are automatically installed with ilo.
Here’s what each one does:

• keyboard-crossplatform – cross-platform keyboard event listener (works on macOS, Windows, and Linux)
• prettytable – generate clean and easy-to-read tables in the terminal
• websocket-client – communicate with the robot via WebSocket
• bleak – Bluetooth Low Energy (BLE) client library for Python
• pyserial – serial communication support (UART)
• pyperclip – cross-platform clipboard support
• requests – simple and powerful HTTP client
• numpy – fundamental package for scientific computing
• matplotlib – powerful plotting and visualization library

---

Documentation

Full documentation and examples are available on GitHub. (Comming soon)

---

Contributing

Bug reports, patches, and suggestions are welcome!

Questions? Contact us via our website.

---