ilo-arena 1.0.0__tar.gz

ilo_arena-1.0.0/PKG-INFO

@@ -0,0 +1,131 @@
+Metadata-Version: 2.4
+Name: ilo_arena
+Version: 1.0.0
+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.  
+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
+
+```bash
+pip install ilo
+```
+
+To update:
+```bash
+pip install ilo --upgrade
+```
+
+---
+
+## Quick Example
+
+Here is a simple example to get started:
+
+```python
+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`](https://pypi.org/project/keyboard-crossplatform/) – cross-platform keyboard event listener (works on macOS, Windows, and Linux)
+- [`prettytable`](https://pypi.org/project/prettytable/) – generate clean and easy-to-read tables in the terminal
+- [`websocket-client`](https://pypi.org/project/websocket-client/) – communicate with the robot via WebSocket
+- [`bleak`](https://pypi.org/project/bleak/) – Bluetooth Low Energy (BLE) client library for Python
+- [`pyserial`](https://pypi.org/project/pyserial/) – serial communication support (UART)
+- [`pyperclip`](https://pypi.org/project/pyperclip/) – cross-platform clipboard support
+- [`requests`](https://pypi.org/project/requests/) – simple and powerful HTTP client
+- [`numpy`](https://pypi.org/project/numpy/) – fundamental package for scientific computing
+- [`matplotlib`](https://pypi.org/project/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`](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>

ilo_arena-1.0.0/README.md

@@ -0,0 +1,97 @@
+<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.  
+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
+
+```bash
+pip install ilo
+```
+
+To update:
+```bash
+pip install ilo --upgrade
+```
+
+---
+
+## Quick Example
+
+Here is a simple example to get started:
+
+```python
+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`](https://pypi.org/project/keyboard-crossplatform/) – cross-platform keyboard event listener (works on macOS, Windows, and Linux)
+- [`prettytable`](https://pypi.org/project/prettytable/) – generate clean and easy-to-read tables in the terminal
+- [`websocket-client`](https://pypi.org/project/websocket-client/) – communicate with the robot via WebSocket
+- [`bleak`](https://pypi.org/project/bleak/) – Bluetooth Low Energy (BLE) client library for Python
+- [`pyserial`](https://pypi.org/project/pyserial/) – serial communication support (UART)
+- [`pyperclip`](https://pypi.org/project/pyperclip/) – cross-platform clipboard support
+- [`requests`](https://pypi.org/project/requests/) – simple and powerful HTTP client
+- [`numpy`](https://pypi.org/project/numpy/) – fundamental package for scientific computing
+- [`matplotlib`](https://pypi.org/project/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`](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>

ilo_arena-1.0.0/pyproject.toml

@@ -0,0 +1,54 @@
+[build-system]
+requires = ["setuptools>=77", "wheel>=0.43"]
+build-backend = "setuptools.build_meta"
+
+[project]
+name = "ilo_arena"
+version = "1.0.0"
+description = "A computer vision and hardware streaming interface for education"
+readme = "README.md"
+requires-python = ">=3.8"
+keywords = ["python", "education", "robot", "ilo", "ai"]
+authors = [
+    {name = "intuition RT (SLB)", email = "contact@ilorobot.com"}
+]
+maintainers = [
+    {name = "intuition RT (SLB)", email = "contact@ilorobot.com"}
+]
+classifiers = [
+    "Development Status :: 4 - Beta",
+    "Intended Audience :: Developers",
+    "Intended Audience :: Education",
+    "Natural Language :: English",
+    "Programming Language :: Python :: 3",
+    "Programming Language :: Python :: 3.8",
+    "Programming Language :: Python :: 3.9",
+    "Programming Language :: Python :: 3.10",
+    "Programming Language :: Python :: 3.11",
+    "Programming Language :: Python :: 3.12",
+    "Programming Language :: Python :: 3.13",
+    "Operating System :: MacOS :: MacOS X",
+    "Operating System :: Microsoft :: Windows",
+    "Operating System :: OS Independent",
+    "Topic :: Education",
+]
+
+dependencies = [
+    "ilo",
+    "pyserial",
+    "opencv-python",
+    "PySide6",
+    "numpy",
+    "torch",
+    "ultralytics"
+]
+
+[project.urls]
+Homepage = "https://ilorobot.com"
+Documentation = "https://ilorobot.com"
+
+[tool.setuptools.packages.find]
+where = ["src"]
+
+[tool.setuptools.package-data]
+"*" = ["assets/**", "*.qss"]

ilo_arena-1.0.0/setup.cfg

@@ -0,0 +1,4 @@
+[egg_info]
+tag_build = 
+tag_date = 0
+

ilo_arena-1.0.0/src/ilo_arena/__init__.py

@@ -0,0 +1,10 @@
+from .facade import Arena, start_arena, Element, list_function
+from ilo.robot import Robot
+
+__all__ = [
+    "Arena",
+    "list_function",
+    "start_arena",
+    "Element",
+    "Robot",
+]

ilo_arena-1.0.0/src/ilo_arena/assets/icons/box.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M200-640v440h560v-440H640v320l-160-80-160 80v-320H200Zm0 520q-33 0-56.5-23.5T120-200v-499q0-14 4.5-27t13.5-24l50-61q11-14 27.5-21.5T250-840h460q18 0 34.5 7.5T772-811l50 61q9 11 13.5 24t4.5 27v499q0 33-23.5 56.5T760-120H200Zm16-600h528l-34-40H250l-34 40Zm184 80v190l80-40 80 40v-190H400Zm-200 0h560-560Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/camera_video.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M371-200h218l-20-80H391l-20 80Zm-11-160h240q83 0 141.5-58.5T800-560q0-83-58.5-141.5T600-760H360q-83 0-141.5 58.5T160-560q0 83 58.5 141.5T360-360Zm63.5-143.5Q400-527 400-560t23.5-56.5Q447-640 480-640t56.5 23.5Q560-593 560-560t-23.5 56.5Q513-480 480-480t-56.5-23.5ZM260-600q17 0 28.5-11.5T300-640q0-17-11.5-28.5T260-680q-17 0-28.5 11.5T220-640q0 17 11.5 28.5T260-600ZM160-120v-80h129l21-84q-99-17-164.5-94.5T80-560q0-117 81.5-198.5T360-840h240q117 0 198.5 81.5T880-560q0 104-65.5 181.5T650-284l21 84h129v80H160Zm433-327q47-47 47-113t-47-113q-47-47-113-47t-113 47q-47 47-47 113t47 113q47 47 113 47t113-47ZM480-560ZM371-200h218-218Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/files.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M160-160q-33 0-56.5-23.5T80-240v-400q0-33 23.5-56.5T160-720h240l80-80h320q33 0 56.5 23.5T880-720v480q0 33-23.5 56.5T800-160H160Zm73-280h207v-207L233-440Zm-73-40 160-160H160v160Zm0 120v120h640v-480H520v280q0 33-23.5 56.5T440-360H160Zm280-160Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/play.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M320-200v-560l440 280-440 280Zm80-280Zm0 134 210-134-210-134v268Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/reset.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M480-320v-100q0-25 17.5-42.5T540-480h100v60H540v100h-60Zm60 240q-25 0-42.5-17.5T480-140v-100h60v100h100v60H540Zm280-240v-100H720v-60h100q25 0 42.5 17.5T880-420v100h-60ZM720-80v-60h100v-100h60v100q0 25-17.5 42.5T820-80H720Zm111-480h-83q-26-88-99-144t-169-56q-117 0-198.5 81.5T200-480q0 72 32.5 132t87.5 98v-110h80v240H160v-80h94q-62-50-98-122.5T120-480q0-75 28.5-140.5t77-114q48.5-48.5 114-77T480-840q129 0 226.5 79.5T831-560Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/select_zone.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M200-120q-33 0-56.5-23.5T120-200v-160h80v160h160v80H200Zm400 0v-80h160v-160h80v160q0 33-23.5 56.5T760-120H600ZM120-600v-160q0-33 23.5-56.5T200-840h160v80H200v160h-80Zm640 0v-160H600v-80h160q33 0 56.5 23.5T840-760v160h-80Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/settings.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="m370-80-16-128q-13-5-24.5-12T307-235l-119 50L78-375l103-78q-1-7-1-13.5v-27q0-6.5 1-13.5L78-585l110-190 119 50q11-8 23-15t24-12l16-128h220l16 128q13 5 24.5 12t22.5 15l119-50 110 190-103 78q1 7 1 13.5v27q0 6.5-2 13.5l103 78-110 190-118-50q-11 8-23 15t-24 12L590-80H370Zm70-80h79l14-106q31-8 57.5-23.5T639-327l99 41 39-68-86-65q5-14 7-29.5t2-31.5q0-16-2-31.5t-7-29.5l86-65-39-68-99 42q-22-23-48.5-38.5T533-694l-13-106h-79l-14 106q-31 8-57.5 23.5T321-633l-99-41-39 68 86 64q-5 15-7 30t-2 32q0 16 2 31t7 30l-86 65 39 68 99-42q22 23 48.5 38.5T427-266l13 106Zm42-180q58 0 99-41t41-99q0-58-41-99t-99-41q-59 0-99.5 41T342-480q0 58 40.5 99t99.5 41Zm-2-140Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/smart_toy.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M160-360q-50 0-85-35t-35-85q0-50 35-85t85-35v-80q0-33 23.5-56.5T240-760h120q0-50 35-85t85-35q50 0 85 35t35 85h120q33 0 56.5 23.5T800-680v80q50 0 85 35t35 85q0 50-35 85t-85 35v160q0 33-23.5 56.5T720-120H240q-33 0-56.5-23.5T160-200v-160Zm242.5-97.5Q420-475 420-500t-17.5-42.5Q385-560 360-560t-42.5 17.5Q300-525 300-500t17.5 42.5Q335-440 360-440t42.5-17.5Zm240 0Q660-475 660-500t-17.5-42.5Q625-560 600-560t-42.5 17.5Q540-525 540-500t17.5 42.5Q575-440 600-440t42.5-17.5ZM320-280h320v-80H320v80Zm-80 80h480v-480H240v480Zm240-240Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/icons/stop.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" height="24px" viewBox="0 -960 960 960" width="24px" fill="#ffffff"><path d="M320-640v320-320Zm-80 400v-480h480v480H240Zm80-80h320v-320H320v320Z"/></svg>

ilo_arena-1.0.0/src/ilo_arena/assets/style.qss

@@ -0,0 +1,156 @@
+/* =======================================================
+   Global Fonts and Background
+======================================================= */
+QWidget {
+    font-family: "Montserrat", "Noto Sans", sans-serif;
+    font-size: 14px;
+    color: palette(window-text); /* Auto-adapts to Light/Dark mode */
+}
+
+QMainWindow, QStackedWidget {
+    background-color: palette(window);
+}
+
+QFrame#AdvancedOverlay {
+    background-color: palette(base); /* White in light mode, dark gray in dark */
+    border-radius: 10px;
+}
+
+/* =======================================================
+   Progress bars
+======================================================= */
+QProgressBar {
+    border: 2px solid palette(mid); /* Subtle border matching the OS theme */
+    border-radius: 10px;
+    text-align: center;
+    height: 25px;
+}
+
+QProgressBar::chunk {
+    background-color: #2ecc71; /* Your success green */
+    border-radius: 8px;
+}
+
+/* =======================================================
+   Labels & Headings
+======================================================= */
+QLabel {
+    color: palette(window-text);
+}
+
+QLabel#titleLabel {
+    font-size: 28px;
+    font-weight: bold;
+    color: palette(window-text);
+}
+
+QLabel#subtitleLabel {
+    font-size: 16px;
+    font-weight: 600;
+    color: palette(placeholder-text); /* Perfect dynamic gray for subtitles */
+}
+
+/* =======================================================
+   Dropdowns / ComboBox
+======================================================= */
+QComboBox {
+    background-color: palette(button);
+    color: palette(button-text);
+    border: 2px solid palette(mid);
+    border-radius: 8px;
+    padding: 5px 15px;
+    font-size: 14px;
+    font-weight: bold;
+}
+
+QComboBox:hover {
+    border: 2px solid palette(highlight); /* OS accent color on hover */
+}
+
+/* The popup list itself */
+QComboBox QAbstractItemView {
+    background-color: palette(base);
+    color: palette(text);
+    border: 1px solid palette(mid);
+    border-radius: 4px;
+    selection-background-color: #24b4b1; /* Matches your teal buttons */
+    selection-color: white;
+    outline: 0px;
+}
+
+/* =======================================================
+   Advanced Settings Controls & Buttons
+======================================================= */
+QPushButton#closeCircle {
+    background-color: transparent;
+    color: palette(window-text);
+    border: none;
+    padding: 0px;
+    font-size: 22px;
+    font-weight: bold;
+}
+
+QPushButton#closeCircle:hover {
+    background-color: palette(midlight);
+    border-radius: 14px;
+}
+
+QPushButton#infoCircle {
+    border: none;
+    padding: 0px;
+    font-size: 13px;
+    font-weight: bold;
+    border-radius: 13px;
+}
+
+QPushButton {
+    background-color: #24b4b1; /* React Teal */
+    color: white;
+    border-radius: 8px;
+    padding: 10px 16px;
+    font-weight: bold;
+    font-size: 14px;
+    border: none;
+}
+
+QPushButton::icon {
+    margin-right: 8px;
+}
+
+QPushButton:hover {
+    background-color: #1e9996;
+}
+
+QPushButton:pressed {
+    background-color: #187c7a;
+}
+
+/* =======================================================
+   Secondary / Back Buttons
+======================================================= */
+QPushButton#backBtn {
+    background-color: palette(mid);
+    color: palette(button-text);
+}
+
+QPushButton#backBtn:hover {
+    background-color: palette(dark);
+}
+
+/* =======================================================
+   Cards / Containers
+======================================================= */
+QTextEdit#LogZone {
+    background-color: palette(base);
+    color: palette(text);
+    border: 2px solid palette(mid);
+    border-radius: 10px;
+    padding: 10px;
+    font-family: 'Consolas', monospace;
+}
+
+QFrame#Card {
+    background-color: palette(base);
+    border: 1px solid palette(mid);
+    border-radius: 12px;
+}

ilo_arena-1.0.0/src/ilo_arena/facade/__init__.py

@@ -0,0 +1,44 @@
+from ilo.robot import Robot
+from prettytable import PrettyTable
+
+from .arena import Arena, start_arena
+from .element import Element
+
+def list_function():
+    """
+    Print the list of all the functions available in the library
+    """
+    main_table = PrettyTable(["Methods", "Description"])
+    main_table.align["Methods"] = main_table.align["Description"] = "l"
+    main_table.add_row(
+        ["ilo_arena.list_function", "Print the list of all the functions available in the library"],
+        divider=True
+    )
+    print(f"{main_table}\n")
+
+    class_configs = [
+        (Arena, "Arena methods (example: my_arena.game())"),
+        (Element, "Element methods (example: my_element.get_robot())"),
+        (Robot, "Robot methods (example: my_ilo.game())"),
+    ]
+
+    for cls, header in class_configs:
+        t = PrettyTable([header, "Description"])
+        t.align[header] = t.align["Description"] = "l"
+
+        for name in dir(cls):
+            entry = getattr(cls, name)
+            if callable(entry) and not name.startswith("_") and entry.__doc__:
+                desc = entry.__doc__.strip().splitlines()[0]
+                t.add_row([name, desc])
+
+        print(f"{t}\n")
+
+    print("If the table does not display correctly, expand your terminal.")
+
+__all__ = [
+    "Arena",
+    "start_arena",
+    "list_function",
+    "Element",
+]

ilo_arena-1.0.0/src/ilo_arena/facade/arena.py

@@ -0,0 +1,79 @@
+from __future__ import annotations
+import threading
+import time
+import sys
+from pathlib import Path
+from typing import List, Callable, Optional, TYPE_CHECKING
+from PySide6.QtWidgets import QApplication
+from ..libs import get_asset_path
+from ..main_window import MainWindow
+
+if TYPE_CHECKING:
+    from libs.robot_connecter import Robot
+from .element import Element
+
+
+class Arena:
+    """
+    The main coordinator for the environment.
+    Gives the student access to fetch active elements, interact with the
+    global space, and yield execution time safely.
+    """
+
+    def __init__(self, main_window: MainWindow):
+        """
+        Initializes the Arena controller.
+
+        Args:
+            main_window (MainWindow): The running application interface.
+        """
+        self._main_window = main_window
+
+    def get_all_elements(self) -> List[Element]:
+        """Returns an array of all elements identified by the AI model."""
+        self.sleep(0.1)
+
+        # Fetch tracked items from the overlay
+        detected_items = self._main_window.page_2.overlay.robots
+
+        return [
+            Element(element_id, self._get_real_element)
+            for element_id in detected_items.keys()
+        ]
+
+    def _get_real_element(self, element_id: int) -> Optional[Robot]:
+        """Internal callback to fetch the latest state of an element."""
+        items = self._main_window.page_2.overlay.robots
+        return items.get(element_id)
+
+    def sleep(self, seconds: float):
+        """Thread-safe sleep function."""
+        time.sleep(seconds)
+
+def start_arena(student_function: Callable[[Arena], None]):
+    """
+    Bootstraps the UI, initializes the AI vision, and runs the student's logic
+    in a safe background thread.
+    """
+    app = QApplication(sys.argv)
+
+    qss_file = Path(get_asset_path("style.qss"))
+    if qss_file.exists():
+        with open(qss_file, "r") as f:
+            app.setStyleSheet(f.read())
+    else:
+        print(f"Warning: {qss_file} not found!")
+
+    # Initialize Backend
+    main_window = MainWindow()
+    arena = Arena(main_window)
+
+    # Spawn the student script in a background thread so the UI doesn't block
+    student_thread = threading.Thread(
+        target=student_function, args=(arena,), daemon=True
+    )
+    student_thread.start()
+
+    # Launch PySide6 Event Loop
+    main_window.show()
+    sys.exit(app.exec())