README.md

metadata

title: Venue Manager Agent
emoji: 🏟️
colorFrom: green
colorTo: indigo
sdk: gradio
sdk_version: 6.18.0
app_file: app.py
pinned: false
tags:
  - track:backyard
  - sponsor:openai
  - sponsor:nvidia
  - sponsor:modal
  - achievement:offbrand
  - achievement:sharing
  - achievement:fieldnotes

Floodlight Venue Manager

Floodlight Venue Manager is a custom venue-ops console for sports venue owners. It turns WhatsApp-style booking requests into an owner-reviewable queue, calendar context, booking details, reply drafts, and safe approval flow.

Links

• App: build-small-hackathon-venue-manager-agent.hf.space
• Demo video and social-media post: X post
• Source repo: curious1n/HF-build-small-hackathon
• HF Article: Venue Manager Running Notes
• Agent traces: modal demo-world suite rows

Demo Flow

1. Open the Floodlight venue-ops console.
2. Review the synthetic venue day, queue, calendar, and booking detail panel.
3. Use Reload Demo to return to the immutable seed world.
4. Send a simulator booking request.
5. Review the extracted booking, trace panel, reply draft, and owner approval state.

Models And Runtime

Runtime path for this v2 demo:

• App host: Hugging Face Space.
• Visible product: custom Floodlight venue-ops console.
• Demo world: one immutable synthetic seed with temporary runtime mutations.
• Reset: top-right Reload Demo restores the seed world.
• Model runtime: Modal, when configured.
• Model: nvidia/Nemotron-Cascade-2-30B-A3B.
• Local/hosted UI demo uses fixture-shaped simulator extraction unless Modal config is supplied.
• No deterministic model fallback is claimed as model proof.

Runtime timing finding:

• H100:2 is a valid proof path for nvidia/Nemotron-Cascade-2-30B-A3B, but the slow first request was dominated by vLLM/model startup, not generation.
• Batch requests reduced suite time by amortizing one model load across many prompts.
• Modal warm preloading now loads the model in @modal.enter(). The bounded warm-preload smoke returned fallback_used=false, schema-valid output with model-side latency about 4.0s and load_llm_end=0.
• End-to-end first-request latency was still about 344s because the request arrived while the warm container was still starting/preloading. Responsive demos should deploy warm, wait for readiness, then begin the human demo.

Evidence

• Local UAT: ../evidence/local-uat.md
• Hosted Space dry run: ../evidence/hf-space-deploy.md
• Modal single-scenario smoke: ../evidence/modal-world-smoke-2026-06-15.md
• Modal demo-world suite: ../evidence/modal-demo-world-suite-2026-06-15.md
• Runtime note: ../reducing-model-execution-time.md
• Agent trace rows: ../evidence/modal-demo-world-suite-20260615-131029/rows.jsonl

Proof claimed by this Space README:

• The hosted package serves the Floodlight app shell and demo-world endpoints.
• The app exposes simulator booking and trace-review surfaces.
• Modal-backed extraction can be wired when the required Space secrets are set.

Not claimed by this Space README:

• Public release readiness.
• Judge-ready status.
• Live WhatsApp/Baileys send.
• External scoring/admin or video telecast integration.

API Surface

Frontend/API integration:

• Demo seed endpoint: GET /api/bootstrap.
• Demo reset endpoint: POST /api/reload-demo.
• Simulator conversation endpoint: POST /api/whatsapp/simulated-message.
• Booking extraction endpoint: POST /api/extract-booking.
• The browser calls the Space endpoint only; the Space server calls Modal privately when Modal config is set.

Optional Space configuration for Modal-backed extraction:

• APP_MODAL_BASE_URL
• APP_MODAL_AUTH_TOKEN
• APP_MODAL_TIMEOUT_SECONDS
• APP_MODAL_MODEL_ID

Known Limits

• The default hosted demo proves the app shell and fixture-backed simulator flow only.
• Fresh hosted Space-to-Modal proof requires a separate fallback_used=false hosted smoke.
• Warm preloading improves model-side request time after the Modal container is ready, but it does not remove the need for a warmup/readiness wait before a live demo.
• The Venue Manager HF Article should be updated from ../articles/running-notes.md when the local source changes.