AI-powered table tennis scoring using real-time vision and voice.
No hardware. No referee. No manual scoring.
Trusted by players worldwide.
Built with Gemini 2.5 Flash · Vision Agents SDK · Ultralytics YOLO
WHAT IS SUPERPONG?
SuperPong is a real-time AI umpire built using computer vision, multimodal AI, and voice interaction. It detects ball movement, determines rally outcomes, updates the scoreboard, and delivers live commentary — all hands-free, running entirely in your browser.
YOLO tracks ball movement at 5fps, detecting rally outcomes and score events in real time.
Wake word activation, natural language commands, undo support — all without touching a device.
Gemini delivers energetic real-time voice commentary after every rally. Point for point.
Score updates in under 1 second. Serve rotation, deuce rules, and best-of sets — fully ITTF compliant.
No installs. Full WebRTC camera + mic stream. Optional Python backend with YOLO for enhanced accuracy.
HOW IT WORKS
Three simple steps. Voice-activated. Fully automatic.
Enter player names, choose your format (11, 21, or best-of sets), and hit start.
Say "SuperPong" to activate. Camera and mic start simultaneously. The AI begins listening.
YOLO tracks the ball at 5fps. Gemini detects rally loss, updates score, and delivers live commentary.
CORE FEATURES
Natural language control with undo and override support. Context-aware — no button presses ever.
Ultralytics YOLO with custom VideoProcessor. Trajectory prediction and auto rally outcome detection.
Real-time voice output with energetic short commentary after every rally point.
Serve rotation, deuce rules, best-of sets. Fully ITTF compliant scoring logic.
Full WebRTC + Python backend, or browser-only Gemini fallback. Your call.
Winner display, point percentage, set breakdown, and full match duration summary.
UNDER THE HOOD
A modular architecture that works in the browser or scales with a Python backend.
React + Vite · Web Speech API wake word · WebRTC camera stream · useAgentConnection hook
Stream WebRTC transport · Vision Agents backend · Gemini Realtime at 5fps · YOLO BallTrackingProcessor
Direct Gemini Live in browser · Silent SYSTEM STATE UPDATE messages · Keeps score context accurate
The framework powering SuperPong. Handles WebRTC, Gemini sessions, and custom video processor integration.
SEE IT IN ACTION
Experience the AI umpire live without any installation. This mode runs entirely in your browser using Gemini Live to handle scoring and commentary.
Camera is disabled in preview mode.
The complete professional setup. Clone the repository and run it locally to enable maximum accuracy with full YOLO ball tracking and your own Gemini API key.