Metadata-Version: 2.4
Name: ilo_arena
Version: 1.0.2
Summary: A computer vision and hardware streaming interface for education
Author-email: "intuition RT (SLB)" <contact@ilorobot.com>
Maintainer-email: "intuition RT (SLB)" <contact@ilorobot.com>
Project-URL: Homepage, https://ilorobot.com
Project-URL: Documentation, https://ilorobot.com
Keywords: python,education,robot,ilo,ai
Classifier: Development Status :: 4 - Beta
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Natural Language :: English
Classifier: Programming Language :: Python :: 3
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: Programming Language :: Python :: 3.12
Classifier: Programming Language :: Python :: 3.13
Classifier: Operating System :: MacOS :: MacOS X
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: OS Independent
Classifier: Topic :: Education
Requires-Python: >=3.8
Description-Content-Type: text/markdown
Requires-Dist: ilo
Requires-Dist: pyserial
Requires-Dist: opencv-python
Requires-Dist: PySide6
Requires-Dist: numpy
Requires-Dist: torch
Requires-Dist: ultralytics

<p align="center">
  <img alt="Ilo robot" src="https://api.ilorobot.com/media/userfiles/ilo.png" height="200">
</p>

<p align="center">
  <img src="https://static.pepy.tech/personalized-badge/ilo?period=total&units=INTERNATIONAL_SYSTEM&left_color=GRAY&right_color=GREEN&left_text=downloads" alt="PyPI Downloads">
  <img src="https://img.shields.io/pypi/dm/ilo" alt="PyPI Downloads / Month">
</p>

**ilo_arena** is a powerful Python package to control **ilo** the new **educational robot** directly from your computer based on a video feed using AI to track the robot.  
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

- Automatic connection to robots in the camera view field
- Automatic detections of elements in the camera view field
- 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  
- Control and read sensors over **Bluetooth**

---

## Installation

```bash
pip install ilo_arena
```

To update:
```bash
pip install ilo_arena --upgrade
```

---

## Quick Example

Here is a simple example to get started:

```python
from ilo_arena import *

def my_logic(arena: Arena):
	while True:
		try:  
		    elements: list[Element] = arena.get_all_elements()  
		  
		    for element in elements:  
		        robot: Robot | None = element.get_robot(element._id)  
		  
		        if robot is not None:  
		            robot.move("front", 45, 100)  
		            arena.sleep(2.0)  
		            robot.rotation(90, finish_state=True)  
		            robot.move("back", 70, 100)  
		            arena.sleep(2.0)  
		            robot.stop()  
		            arena.sleep(1.0)  
		  
		except Exception as e:  
		    print(f"Error encountered: {e}")  

if __name__ == "__main__":
	start_arena(my_logic)
```

---
## Documentation

The control of the robot depends on the [`ilo`](https://pypi.org/project/ilo/) library.

---

## Contributing

Bug reports, patches, and suggestions are welcome!

Questions? Contact us via [`our website`](https://ilorobot.com).

---

<p align="center">
  <a href="https://ilorobot.com">
    <img src="https://img.shields.io/badge/Powered_by-Intuition_RT-%234A75A0?style=for-the-badge&logo=python&logoColor=white" alt="Powered by Intuition RT">
  </a>
</p>
