README.md

---
title: NumZoo
emoji: 🦁
colorFrom: purple
colorTo: pink
sdk: gradio
sdk_version: "6.17.3"
app_file: app.py
pinned: false
license: apache-2.0
tags:
  - flux
  - text-to-image
  - kids
  - education
  - math
---

# 🦁 NumZoo

A mental math app for kids — answer questions, earn cute AI-generated animal images as rewards!

## How it works

1. Enter your name
2. Pick your favourite animals 🐾 and places 🌍 (used to personalise reward images)
3. Answer math questions — every **3 correct answers** earns a reward image
4. Level up: **Additions → Subtractions → Multiplications → Mix**

## Levels

| Level | Operation | Goal |
|-------|-----------|------|
| 1 | ➕ Additions | 5 correct |
| 2 | ➖ Subtractions | 5 correct |
| 3 | ✖️ Multiplications | 5 correct |
| 4 | 🎲 Mix | Endless |

## Image model

Rewards generated with **FLUX.2-klein-4B** (4B params, Apache 2.0) via 🤗 Diffusers.  
Images start generating in the background as soon as the quiz begins.

## Run locally

> Requires Python on Apple Silicon (arm64). Recommended: [Miniforge](https://github.com/conda-forge/miniforge).

```bash
# 1. Install dependencies
~/miniforge3/bin/pip install -r requirements.txt

# 2. Accept FLUX.2-klein-4B license on HuggingFace
#    → https://huggingface.co/black-forest-labs/FLUX.2-klein-4B
#    Then log in:
hf auth login

# 3. Run
~/miniforge3/bin/python3 app.py
# Opens at http://localhost:7860
# First run downloads ~23GB of model weights (cached after that)
```

> On standard Python/pip (non-Apple Silicon):
> ```bash
> pip install -r requirements.txt
> python app.py
> ```