Docs: update CLAUDE.md + README for FLUX.2-klein-4B

Make HF cache setup bulletproof — never crash import, fall back to ephemeral

Fix poisoned HF cache: fresh path + self-healing wipe

Fix cache cleanup: wrap removals in try/except, also clear .locks placeholder

Fix HF Spaces startup: restore spaces import + clear stale cache placeholders

Restore startup pre-download for FLUX.2-klein-4B on HF Spaces

Fix: restore @spaces.GPU decorator required by ZeroGPU

Upgrade image model to FLUX.2-klein-4B + align training pipeline

Restore icons in status bar and enforce consistent panel width

Improve level experience: better status bar + level 5+ harder difficulty

add samples and banner

Add banner image to app header with styled title

Fix wrong-answer feedback; add numeric keyboard on mobile

Fix My Collection title card in dark mode

Revert emoji pre-selection to 1 animal + 1 place

Improve UI workflow: clean quiz, collection title card, no spinners

Remove streak from prompt; support up to 3 animals and places

Fix collection display: replace JS polling with server-side render

Add training dataset generator + fix MPS dtype for local inference

Remove startup model pre-caching — let from_pretrained cache in container

Fix .locks dir placeholder — also repair cache_root/.locks/models--*/

Fix: repair entire HF cache tree of placeholder files at startup

Fix FileExistsError on cache path: unlink placeholder file before makedirs

Change cache path to /data/hf_cache to avoid storage git conflict

Fix ENOTDIR by validating every cache path level; add diagnostics

Fix corrupt cache detection (lexists) and suppress asyncio GC noise

Fix corrupt cache entry and asyncio fd warning on startup

Redesign game loop: level-based flow with reward at end of each level

Revert share=True — not supported on HF Spaces

Enable share=True for public Gradio link

Fix FileExistsError on /data/huggingface/hub mkdir

Async pre-generation, fix loader, fix collection display

Run snapshot_download in thread to suppress asyncio fd warning

CLAUDE.md: document audioop-lts Python version constraint

Remove audioop-lts from requirements — only needed on Python 3.13+

scripts: remove hardcoded paths, clean up run.sh kill logic

Use persistent storage (/data) for model cache on HF Spaces Pro

Remove snapshot_download at startup — crashes container (16Gi limit)

Fix loader duplication, multi-animal prompts, add Collection gallery

Fix ZeroGPU: pre-cache model at startup, use cuda directly on HF Spaces

Emoji picker: CSS grid layout, centered, 2 rows per category

Pass HF_TOKEN to FluxPipeline for gated model access on HF Spaces

Fix step title padding — use broader .prose h3 selector

scripts/run.sh: kill all stale instances before starting

Widen layout, more title padding, verbose image gen logging

UI improvements: centered layout, emoji toggle chips, localStorage name persistence

Add dev scripts + simplify CLAUDE.md

Fix image generation: use .then() chain instead of unserializable Future

Fix: remove gradio from requirements.txt, bump sdk_version to 6.17.3

Fix: pin gradio>=6.0.0 to resolve HfFolder import error on Python 3.13