Inspiration
Everyone knows the moment: the film freezes, the spinner appears, and you have no idea why. Streaming apps are great at recommending what to watch but tell you nothing when playback goes wrong. We wanted one companion that does both, and explains itself honestly.
What it does
NYSUS recommends films and shows from natural requests like “something like Interstellar but darker”, giving a reason for every pick. Its retro TV player, with working Channel, Picture and Volume knobs, tracks every stall, rebuffer and quality drop across simulated network scenarios or your own live connection. When playback struggles, the Ask NYSUS assistant runs real diagnostic tools on your session, explains the cause, cites the exact playback events as evidence and flags any number it can’t back up. Guests can try it instantly with a demo profile, or sign in with Google to save their watchlist.
How we built it
The assistant runs on Gemini with function calling across six tools covering discovery, taste, playback health, comparisons and reports. Recommendations show whether they ran on-device or in the cloud. Firebase handles hosting, anonymous and Google sign-in, and Firestore storage behind strict security rules, with App Check protecting the AI calls. The work was built in phases and covered by 180 automated tests, including a full end-to-end Playwright flow.
Challenges we ran into
Stopping the AI from inventing numbers was the hardest part, so every claim had to trace back to a real event ID. Getting the guest-to-Google sign-in right took several attempts, so that demo data stays separate and only your own saves carry over. We also caught a debug security token leaking into the public build and blocked it at build time.
Accomplishments that we’re proud of
An assistant that shows its evidence instead of asking you to trust it. A retro TV player that is fun to use and still accessible, with standard controls underneath. And a full app, live and tested, built in a few weeks.
What we learned
Grounding an AI in tool results makes it far more trustworthy than prompting alone. We also learned how much of shipping is security rules, sign-in edge cases and deployment, rather than features.
What’s next for NYSUS
Diagnostics running in real streaming players, smarter quality advice tuned to your connection over time, shared watchlists, and a browser extension that brings Ask NYSUS to the services you already use.tion
Built With
- cloud-firestore
- firebase
- firebase-app-check
- firebase-authentication
- firebase-hosting
- gemini
- google-cloud
- google-sign-in
- html5
- node.js
- npm
- playwright
- recaptcha
- typescript