# Olá, mundo! — a little Portuguese, every day A free, gentle Portuguese learning game for young children. **Pipo**, a friendly sunny bird, helps them listen to words, match pictures, read tiny stories and try a short conversation. **Play it:** https://ola-mundo-pt.pages.dev ## Who it's for Young beginners, ages about **4 to 9**, learning Portuguese from scratch, ideally with a grown-up nearby. Help text is in **English or Dutch**, and you can choose **European Portuguese** or **Angola** voice preferences. It is built to be a short, calm daily habit, not endless screen time: a parent sets a **daily minutes limit** for each learner, and there are no ads and no accounts. ## How to play 1. Open **For parents** (a small sum keeps little fingers out). Pick the help language, Portuguese variety, a theme and the daily minutes. 2. Choose a learner: **picture explorer** (listening and picture games, very short turns) or **little reader** (short dialogues, typing and stories). 3. Try **Words** to hear new words, **Play** for six quick questions, **Listen** for a listening game, **Stories** for four-page picture stories, and **Talk** to chat with Pipo using the words you know. There are 20 themes (greetings, family, colours, numbers, food, animals, school, weather, beach, Angola and Portugal, and more), 173 words and 10 original stories. Stars grow as words are remembered, with spaced reviews after 1, 3, 7, 14 and 30 days. ## Privacy Everything runs in the browser. Progress, nicknames and settings are stored only in that browser's local storage. There are no accounts, analytics, trackers, external assets or paid APIs, and nothing a child types leaves the device. Speech uses the device's own built-in voices when they exist. ## Run it locally The game is a static site: serve the `public/` folder with any web server. With Node.js 22 or newer you can also use the included local server: ```sh git clone https://github.com/efesantos/portuguese-tutor.git cd portuguese-tutor npm start # then open http://127.0.0.1:4387 npm test # core tests, no install needed npm ci && npm run test:browser # headless browser tests ``` The local server can optionally connect Pipo to an OpenAI or Anthropic model with your own key. The model can only pick a prewritten lesson line; it never writes text for the child. See [docs/DETAILS.md](docs/DETAILS.md) for that, the safety design, speech, the curriculum format and the test notes in [docs/VERIFICATION.md](docs/VERIFICATION.md). ## Credits and licence Built by **Elmer Santos** with AI agents. The stories, curriculum and drawings are original. [MIT licence](LICENSE).