build-small-hackathon/the-apprentice

update readme for compatibility (#1)

Update README.md

README: add Idea + Tech write-up, link section, llama-champion + sharing-is-caring YAML tags

README: recommend local --full run for best visual experience

README: drop emojis from loading-time and cold-start note labels

Pre-warm Modal LLM at app startup + document cold-start behavior in README

Clean-Space pass: drop self-test, legacy unused handler, BISECT_MINIMAL branch, duplicate banner PNG, stale comments

Claim 🦙 Llama Champion badge — GGUF + llama-cpp-python path is shipped

Add X/social post URL

Add 3-playthrough sample trace + README (Sharing-is-Caring deliverable)

Add HF blog post URL alongside the in-repo field notes

Trace-sharing infra: traces/sample is committable, add curation script + README badge claim

Default LLM-call tracing to ON — writes to ./traces unless ORACLES_TRACE_DISABLE=1

Trace: log both model_requested and model_returned for Sharing-is-Caring badge

README: demo video link, loading-time note, lean/full guidance, point to apprentice field notes

Lean mode: also strip pipeline-demo encounter/resolve sprites

Add visual-mode dropdown on step 0 — live toggle between lean and full

run.sh: print clear localhost:7860 banner — 0.0.0.0 fails in Chrome

URL-encode sprite paths so spaces in dev path don't truncate <img src>

Version-aware Gradio file route — /file= on 4.x, /gradio_api/file= on 5+

Default --keep-warm and add --stop-on-exit + safer launch for Gradio 4/5/6

Add ORACLES_VISUAL_MODE toggle — lean default, full enabled via --full or env var

Remove gr.skip diff — broke multi-yield generator handlers, blocking grimoire->trial transition

Relax LLM output validation: lower word floor, +1 retry, salvage missing tactic

Drop demo_card_backdrop image — pipeline-demo panels use CSS only

Drop wizard-desk backdrop + open-book illustration — more HF load-time wins

Drop heavy backgrounds (parallax, grimoire texture, phase + scene backdrops) for HF perf

Performance sweep: gr.skip diff + memoize hot HTML helpers per click transition

Memoize hot HTML helpers and lazy-load image module sprites for faster transitions

Serve banner parallax PNG via /gradio_api/file= — drops ~270KB from every click response

Remove unsupported @import + register assets via set_static_paths

Revert to /gradio_api/file= URL pattern — Gradio 5 file route

Try /file= route for sprite URLs instead of /gradio_api/file=

Serve sprites via /gradio_api/file= instead of base64 — initial HTML drops ~95%

Turn bisect probe off — render full app on Docker

BISECT: temporarily swap build_app() with minimal probe via BISECT_MINIMAL=1

Switch to Docker SDK on HF Space — full control over launch, no auto-launcher

Drop fastapi pin — conflicts with gradio 5.29.1 (needs fastapi>=0.115.2)

Pin Gradio 5.29.1 (last known-good HF Space version) + fastapi 0.112.2

Address Gradio 6 deprecation: set theme+css as Blocks attrs, not constructor args

Define demo at module scope so HF Space's hot-reload launcher applies theme+css

BISECT 1: temporarily disable theme + css to test if they break Gradio 6 iframe render

Disable Gradio 6 SSR — Node-proxy SSR stalls on the large data-URI HTML

Gradio 6 API migration: theme + css to launch(); drop show_api

Bump to Gradio 6.18 — drops dependency pins; current stable HF Spaces line

Roll back to Gradio 4.44.1 to match local dev

Pin starlette<0.40 — TemplateResponse signature

Disable Gradio 5 SSR — hydration fails inside

Re-add huggingface_hub<0.34 pin — gradio 5.0.x

Bump Gradio to 5.x and bind launch to