LallaLab: a collection of games

Challenged by a friend of mine (speech therapist), I vibe-coded this series of simple games using Pygame. The games are inspired by the esercizi per la mente project.

So far, the collection contains eight games designed to strengthen key cognitive functions that support communication — such as attention, memory, executive functions, and visuospatial abilities.

Quick start

python -m venv .venv
source .venv/bin/activate  # Windows: .venv\Scripts\activate
pip install -e .
arcade

or simply,

python3 -m src.arcade.launcher

Project layout

pygame-arcade/
├─ pyproject.toml
├─ README.md
├─ .gitignore
├─ assets/
│  └─ (images, etc.)
└─ src/
   └─ arcade/
      ├─ __init__.py
      ├─ launcher.py
      ├─ core/
      │  ├─ __init__.py
      │  ├─ assets.py
      │  ├─ backgrounds.py
      │  ├─ config.py
      │  ├─ display.py
      │  ├─ help.py
      │  └─ scene.py
      └─ games/
         ├─ __init__.py
         └─ game_example/
            ├─ __init__.py
            ├─ game.py
            └─ assets/
               └─ (images, etc.)

Controls

• Launcher: Up/Down to move, Enter/Space to launch, Esc to quit.
• In games: Esc returns to launcher.

Add a new game

1. Create a new folder: src/arcade/games/tetris/
2. Create game.py with a @register("Tetris") function that returns a Scene.
3. Run arcade — the launcher auto-discovers games.

The file dev-guide.md contains some (AI generated) guidelines such that your favorite LLM can understand the setting of the project.

Gallery