Skip to content
alberto bermudez
← All work
§03·2026·Solo buildWalkthrough soon

TrivAI

Multiplayer AI trivia: upload study material, compete in real-time on AI-generated quizzes.

Summary

A real-time multiplayer trivia game where players upload PDFs and compete on AI-generated questions. Includes an AI tutor, friend system, analytics dashboard, and LAN-mode for offline play.

The problem

Studying alone is unmotivating; group quizzes need someone to write questions. Both problems disappear if an LLM can generate a curriculum-grounded multiplayer quiz from your own notes.

Approach

  1. 01Upload PDFs → embed via HuggingFace → FAISS index per study room.
  2. 02Generate MCQ batches with GPT-4o, grounded by retrieved chunks.
  3. 03FastAPI + SSE for round timers; SQLModel/PostgreSQL for state.
  4. 04Next.js 16 client with framer-motion micro-animations.

Results

  • →Full Docker Compose stack; works on LAN with auto-IP detection
  • →Multi-language UI (EN/DE/ES), email + GitHub OAuth
  • →End-to-end CI/CD on GitHub Actions

Highlights

  • ·RAG pipeline turns any PDF into a quiz
  • ·Synchronised 30-second rounds with in-game leaderboard
  • ·Document-grounded AI tutor for incorrect answers
  • ·Analytics dashboard with CSV/PDF export