| --- |
| 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.1-schnell** (12B 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.1-schnell license on HuggingFace |
| # → https://huggingface.co/black-forest-labs/FLUX.1-schnell |
| # 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 |
| > ``` |
|
|
