Install the app and run your first robot
One download, one double-click, and you are programming. The Smart Home League app carries the whole competition inside it — the simulated house, the robot, the sensors, Python, the lessons and the code helpers. There is nothing else to install.
🆕 Smart Home League 2.1.1 was released — 4 November 2026.
Download the app again: the files below are 2.1.1, and the browser version at /game is already running it. The rules changed, and the app plays by the new ones:
- 180 seconds in every division, First Step included.
- The stuck watchdog fires at 10 seconds inside a 0.85 m circle; the robot lands on a random free tile at least 6 tiles away.
- A relocation costs a flat 2 tiles — and nothing at all while you own fewer than 10. The climbing 5 / 10 / 12 fine is gone.
- No overtime. A draw is a draw, worth a point each; a drawn knockout game is replayed.
- The rulebook (PDF and Word, both languages) is rewritten from the engine and now covers the Swiss league, byes, tiebreaks and playoffs.
The full rules are on the competition rules page, and the referee's book with
every number ships inside the app as RULES.md.
1. Download the app — or play in the browser
Nothing to download? The whole game also runs right here in your browser: Open the game in the browser It is the same release as the files below, with the same house, robot and rules. Chrome, Edge, Firefox and Safari all work; a laptop or desktop is best because the editor needs a keyboard. The downloadable app is the better choice for competition day and for a club with a weak connection, because it needs no internet at all once it is on the computer.
Pick the file that matches your computer. All three are the same release — 2.1.1 — and the same competition: a team on Windows, a team on macOS and a team on Linux see an identical house, an identical robot and identical rules.
Windows · 2.1.1 — 9.6 MB macOS · 2.1.1 — 0.7 MB Linux · 2.1.1 — 0.7 MB
| Your computer | The file | What is inside |
|---|---|---|
| Windows 10 / 11 | SmartHomeLeague-Windows.exe | One program. Double-click it — no installer, no Python to set up |
| macOS | SmartHomeLeague-Mac.zip | One .command file plus a read-me. macOS already has the Python it needs |
| Linux | SmartHomeLeague-Linux.zip | One .sh file plus a read-me. Needs python3, which desktop Linux already has |
The macOS and Linux files are small because they carry the game compressed inside the launcher itself; the Windows one is larger only because it brings its own copy of Python. Nothing is installed on any of the three — the game runs out of memory and leaves nothing behind.
No internet needed after the download. The app runs entirely on your own computer, so a club with a weak connection can still train and compete.
2. Open it — Windows, macOS, Linux or the browser
In the browser
- Go to
smarthomeleague.ir/game. There is nothing to install and nothing to allow. - The first load fetches a few megabytes; after that the page starts instantly and your code stays in this browser (it is saved locally, not on our server).
- Everything the app has is there: the three divisions, the editor, the lessons, the helpers and the referee tools. Use the same browser and the same computer to find your saved code again.
Windows
- Double-click
SmartHomeLeague-Windows.exe. - If Windows shows a blue Windows protected your PC notice, choose More info and then Run anyway. That notice appears for any new program that has not yet been downloaded by thousands of people; it is not a warning about this file specifically.
- The league opens in its own window. That is all — there is no installer and no setup.
macOS
- Unzip
SmartHomeLeague-Mac.zip(double-click it). - Inside you will find
Smart Home League (Mac).command. Right-click it and choose Open, then Open again in the dialog. - macOS only asks this the first time. Afterwards a normal double-click is enough.
If macOS still refuses: open Terminal, type bash and a
space, then drag the .command file into the Terminal window and
press Return.
Linux
- Unzip
SmartHomeLeague-Linux.zip. - In a terminal, in the folder you unpacked to, run
./'Smart Home League (Linux).sh'. - If that says permission denied, the execute bit was lost in transit. Either
chmod +x 'Smart Home League (Linux).sh', or run it through the shell, which never needs the bit:sh 'Smart Home League (Linux).sh'. - The league opens in its own window if Chrome, Chromium, Edge, Brave or Vivaldi is installed; otherwise it opens in your default browser. Closing the terminal stops the game and deletes its temporary files.
The one requirement is python3, which essentially every desktop
Linux already has. If it is missing:
sudo apt install python3 (Debian, Ubuntu, Mint),
sudo dnf install python3 (Fedora), or
sudo pacman -S python (Arch, Manjaro).
3. Pick your division
The app opens on the division picker. Choose the one that matches the age of your team — the house, the sensors and the rules change with it.
| Division | Age | What makes it different |
|---|---|---|
| First Step | newcomers | Sense and react. Three forward distance sensors, a colour sensor and a bumper ring that tells front from back (bumperfront, bumperback); the score is simply how much floor you cleaned. |
| U14 | primary | Adds the compass, room numbers and per-room cleaning percentages. The colour sensor is already in First Step. |
| U19 | secondary | Adds GPS with goto(x, y), and a battery that runs down and has to be recharged at the station. |
4. Run your first robot
- Open Match mode.
- Press Base code to load the starter program — it is commented line by line, in both languages, and it already drives and avoids walls.
- Press Start. Every floor tile the robot drives over turns your colour, and the score is the percentage of the house you cleaned before the clock runs out.
- Change one number in the code, run it again, and watch what happens. That loop — change, run, look — is the whole competition.
The robot is ready-made. No team builds hardware. What you build is the robot's brain: a Python program that runs ten times a second and commands the wheels.
5. Lessons, helpers and the base code
- The tutorial lives inside the app — seventeen lessons, in Persian and English,
from the first
forward()to reading sensors and writing your own functions. - The helpers build real Python for students who cannot type it yet: one asks questions, the other stacks puzzle blocks. Both hand back code you can read and edit.
- The rulebook and the lesson booklets are separate PDFs, one per division, in both languages — get them from the team area.
Before you compete
- Create your team account on the join page so an organiser can approve you and you can reach every download in one place.
- Read the rulebook — scoring, penalties and the technical interview are all in it.
- Teacher, coach or parent? The schools and coaches guide explains how to run the league in a classroom or a robotics club.
- Stuck? Ask on the Telegram channel or the league Discord.
Fair play: the code you submit must be your own. Copying another team's work is not accepted, and the organisers' decisions on such matters are final.
Frequently asked questions
What do we need to install?
Nothing. The app is one file and contains everything — the house, the robot, Python, the lessons and the helpers. Just a Windows, macOS or Linux laptop.
Windows says the file is not commonly downloaded.
That appears for any new program. Choose More info and then Run anyway.
On macOS the file will not open.
Unzip it first, then right-click → Open → Open. macOS only asks the first time.
If it still refuses, run it from Terminal with bash and the file
dragged in.
Which language do the students write?
Python. The program runs ten times a second and commands the wheels.
Do we have to build the robot?
No. The robot is ready-made in every division; you write the code and pick a colour.
What if a student has never programmed before?
First Step is made for newcomers, and the helpers inside the app turn questions or puzzle blocks into real Python. More in the vacuum robot league guide.