numzoo / README.md
goumsss's picture
Docs: update CLAUDE.md + README for FLUX.2-klein-4B
2b1f846
|
Raw
History Blame
1.61 kB
metadata
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.

# 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):

pip install -r requirements.txt
python app.py