Inspiration
What it does
How we built it
Challenges we ran into
Accomplishments that we're proud of
What we learned
What's next for HyperCue Studio: Qloo Agentic Greenlight & Touring War-Room
Inspiration: The $200M Cultural Blindspot
Entertainment studios (A24, Sony Pictures, Eldridge), music supervisors, and global tour promoters (Live Nation) risk $50M–$200M per slate guessing which music sync tracks, directors/cast, brand sponsors, and international territories will resonate with target cohorts.
When teams ask a Vanilla LLM (Without Qloo) to package a film or route a tour, three systemic failures occur:
- Unverified Cultural Stereotypes: Recommends over-licensed $250K pop clichés with
0.19niche audience overlap. - Schema & Endpoint Hallucinations: Passes invalid age ranges (
25_to_34instead of Qloo's 6 valid buckets) or wrong entity URNs (urn:entity:videogameon/v2/insightsinstead ofurn:entity:video_game). - Cold-Start Fabrication: Invents fake entity IDs and fake affinity percentages for unindexed/fictional titles instead of abstaining.
What it does
HyperCue Studio is an end-to-end multi-agent cultural greenlight, sync licensing, and global territory/touring war-room powered by Qloo Taste AI (hackathon.api.qloo.com + @qloo/qloo-harness v0.1.26):
- Live Hosted Web App (Zero Login Required): https://kevin9327.github.io/HyperCueStudio/
- Public Open-Source GitHub Repository (
MITLicense): https://github.com/kevin9327/HyperCueStudio
1. Adversarial 3-Agent Greenlight & Sync Courtroom
- Creative Advocate Agent: Queries Qloo
/searchand/v2/insightsacrossurn:entity:artist,urn:entity:person, andurn:entity:brandwithfeature.explainability=true, surfacing high-affinity sync tracks (Massive Attack0.97, Portishead0.92, Nils Frahm0.87) and brand sponsors (A240.96, Acne Studios0.91, RIMOWA0.90, Le Labo0.89). - Clearance & Budget Skeptic Agent: Audits sync licensing caps (
$180K) and binds pre-cleared FlowMusic.app stems (cue_01_trip_hop_drama.mp3,cue_02_latin_noir_thriller.mp3,cue_03_neosoul_late_night.mp3), saving $135,000+ in master/publishing fees. - Chief Cultural Judge Agent: Enforces a deterministic
0.30Qloo Affinity Veto Gate—automatically vetoing low-affinity mismatches (Ibiza Euro-Trance Anthems @0.184 < 0.30) and computing Cross-Anchor Cultural Compatibility (88.4%) via/v2/analysis/compare.
2. Dynamic Film Territory & Live Nation Tour War-Room
Ranks global stops (Seoul 0.948, Los Angeles 0.961, Tokyo 0.919, London 0.892, Paris 0.876, Mexico City 0.854) by Qloo Affinity-per-CPA Efficiency:
$$\text{Efficiency} = \frac{(\text{Qloo Affinity})^{1.5}}{(\text{CPA Index})^{0.65}}$$
Simulates real-world constraint shocks (Drop UK-LON + Slash P&A Budget 40% + Lock KR-SEL) and deterministically reallocates $720,000 and local brand activations in <10ms.
3. Multi-Modal Pre-Viz & HeyGen HyperFrames Trailer Studio
Renders a deterministic 1080p 30fps executive pitch & pre-viz trailer using HeyGen HyperFrames (v0.8.192), Google AI Studio (Gemini 3.8 Flash TTS) narration, and FlowMusic.app stems normalized to -14 LUFS.
4. E6 Quantitative Benchmark (+178.5% NDCG@5 Lift) & Cold-Start Abstention Guard
Audited across 12 scenarios (BM-01 to BM-12), lifting Mean NDCG@5 from 0.337 (Vanilla LLM) to 0.938 (+178.5%) with 100% constraint satisfaction and 0 hallucinated entities. Deterministically abstains when queried with unindexed/fictional comps ("Quantum Banana Odyssey 2099").
5. @qloo/qloo-harness v0.1.26 MCP & SAFE_USE.md Provenance
Exposes 13 MCP tools (.mcp.json), scrubs PII ([REDACTED_EMAIL], [REDACTED_PHONE], [REDACTED_SSN]) before any external call, and explicitly separates Qloo Empirical Facts from Agent Model Interpretation.
Built With
- css3
- fastapi
- gemini
- html5
- javascript
- mcp
- python
- qloo