Smart Home League
Program your smart vacuum robot in Python, clean the house and race the other teams — a league built for REAL learning of robotics and coding, from the very first step to the championship.
Get started — one download and you are in
Everything you need to run the official competition on your own computer, in one place.
The league app
One file with everything inside: the house, the robot, the sensors, Python, the lessons and the code helpers.
The app for Windows The app for macOS The app for LinuxThe rules and the lesson booklets
The rulebook and a lesson booklet for every division, in Persian and English.
کتابچهی قوانین (فارسی) Rulebook (English)Your team account
Create an account and every download — apps, rulebooks, booklets and the base code — sits in one place.
Create your team account Step-by-step install guideThen: open the app → pick your division → load the base code → press . That’s it — you are in the league!
What is the Smart Home League?
A platform for the next generation of smart-home innovators to learn robotics hands-on.
Learning first
The league is educational at its core: kids write algorithms, read sensors and solve real problems in a safe simulated home — no hardware needed.
A smart vacuum robot
Every team programs the brain of a vacuum robot: explore the house, clean the tiles, dodge the obstacles and beat the rival.
A global community
The league runs under the worldwide FIRA competitions — from Iran all the way to the World Cup in Vancouver, Canada. There is a place for you here!
Age divisions
Anyone can start at any level — from the first step to pro.
First Step
For newcomers and the youngest — no minimum age. A friendly first meeting with robotics and coding.
- 3 forward distance sensors, bumper ring and colour sensor
- Simple Python coding
- A different map every round
U14
One step up: for young roboticists who want to go deeper into algorithms and problem solving.
- First Step sensors plus the compass
- Focus on algorithms & strategy
- A foundation for bigger arenas
U19
The peak of the league; advanced skills and real innovation, with its own extra rules and hardware.
- GPS sensor for precise positioning
- Wireless charging — manage your battery!
- Fixed map with changing objects
How does the competition work?
A simulated house, a vacuum robot, and the code YOU wrote.
Know the house
Each round the teams get a unique house — rooms cluttered and polluted by everyday life. In U19 the house layout is fixed and only the objects change place.
Write the robot's brain
In Python: read the distance sensors of your division and steer by them — and in U19 use the GPS too — then decide how your vacuum explores and cleans.
Clean & score
Scoring measures the cleanliness you achieve: floor-tile coverage and the cleaning level reached within the match time, in every map and condition you are given. The best algorithm wins!
Dodge & survive
Furniture and household obstacles block the way — find them with your sensors and go around without damage. In U19 you even manage the battery: recharge on the green wireless-charging zones.
The competition environment
Straight from the app — the official U14 house the teams compete in.
Core rules
What every participant must know — the full official text is linked below.
Scoring
The core metric is cleanliness: tile coverage and cleaning level within the time limit. Teams must optimise their algorithm to perform in every map and condition.
Fair play
Honesty and respect are the foundation. Any cheating or exploiting of loopholes faces serious penalties — up to disqualification.
Original code
All code must be the team's own original work. Copying code or unauthorised external libraries is a violation.
Organizers' discretion
In ambiguous cases the committee decides, and its decision is final. Questions? Talk to the technical committee respectfully.
Upcoming competitions
The Smart Home League runs at the FIRA competitions. These are the next dates.
Start here — three steps
Join, read the rules, look at the map. Everything else follows from those three.
1. Join
Sign up so we can tell you when the rules or the files change.
2. The rules
Competition tools
Everything you need to practise and compete — all free.
THE MAIN competition — the league app
The real league runs inside the league app. Download it for Windows or macOS — the house, the robot and Python are already inside:
- Nothing else to install — Python, the house and the robot are inside the app
- Open it, pick your division, press Base code, press Start
- The base code for every division is one click away inside the app
The competition in your browser
The same competition the app runs, opened straight in the browser — same house, same robot, same Python, nothing to install. Handy for a classroom or a quick try.
Where the league has been
Every competition already held.
Partners & the global network
