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

Share this project:

Updates

Submission history