First Runner APP

CONQUISTE A CIDADE CAMINHANDO, CORRENDO E PEDALANDO. IMPULSIONADO POR A.I GEMINI

Comment 9

🏙️ First Runner — Conquer the City by Running

The Problem: The Sedentary Epidemic in the Digital Age Modern fitness apps are static text boxes and boring graphs. They track your run, but they don't engage you. Motivation fades. We created First Runner to gamify the physical world, turning your daily route into a strategic turf war driven by a hyper-responsive, real-time AI coach powered by Google Gemini.

The Solution: A Cyberpunk Turf War First Runner is a gamified, location-based fitness app where users conquer real-world city territories by physically running, walking, or cycling.

• Territory Dominion: Every mapped street is a grid ready to be claimed. Paint the city with your clan's colors. • The Oráculo (Live AI Coach): Our crown jewel — powered by Gemini 2.5 Flash Native Audio. It talks to you during the run, handles barge-in interruptions mid-sentence, knows your real-time GPS pace and territory status, and responds in under 1 second.

─── How It Maps to the 3 Challenge Tracks ───

🎙️ Live Agent (Primary Track) The Oráculo is a continuous voice agent that listens, responds, and handles real interruptions during a live run. No turn-based delays. Context-aware via real-time GPS telemetry injection into the Gemini session.

🎨 Creative Storyteller After each run, the Oráculo delivers a "Mission Debrief" — a multimodal narrative mixing epic text, map snapshots, and performance stats in a single interleaved output stream.

🖥️ UI Navigator The agent receives screenshots of the tactical map HUD, interprets red zones (enemy territories), and alerts the runner about visual changes in real-time.

─── The Architecture ─── The Flutter app captures raw 16kHz PCM audio and streams it via WebSocket to our Node.js bridge on Google Cloud Run. This bridge orchestrates a bidirectional Gemini 2.5 Flash Native Audio session. Simultaneously, the app silently injects live GPS telemetry (pace, distance, territory status from Firestore) into the context — making every response tactically relevant.

─── Tech Stack ─── • Google GenAI SDK + Gemini 2.5 Flash Native Audio — live voice coach • Google Cloud Run — WebSocket backend • Firebase Firestore + Auth — real-time territory sync • Flutter (Dart) — cross-platform mobile frontend • OpenStreetMap + Nominatim — map tiles and geocoding (third-party) • WalletConnect + web3dart — blockchain achievements (third-party)

─── Key Challenges Solved ─── • Barge-in without feedback loop: AudioContextAndroid + gainTransientMayDuck + PCM buffer management • Zero-latency telemetry injection: silent JSON context updates without breaking the audio stream • Resilient WebSocket reconnection during runs in low-signal areas

─── Findings & Learnings ─── Native Audio was the game-changer. Bypassing TTS made the Oráculo feel like a living entity, not a script. We learned that grounding the AI with real GPS context — territory status, pace, rival positions — transforms generic motivation into genuine tactical coaching. The future of interaction is continuous, multimodal presence.

─── Business Model ─── B2B physical traffic platform: gyms, pharmacies, and retailers become official pit stops. The Oráculo guides runners to partner locations via contextual audio missions.

Built for the Gemini Live Agent Challenge 2026 | #GeminiLiveAgentChallenge

📝 Behind the build: https://medium.com/@tpd.egon89/como-construí-um-jogo-de-corrida-cyberpunk-com-gemini-live-ai-e-o-que-aprendi-no-caminho-9c53b5db9577

Built With

Share this project:

Updates

posted an update —

Most Artificial Intelligences live on screens. We decided to take AI to the streets. I'm very proud to share the project we developed for Google's Gemini Live Agent Challenge: First Runner. First Runner isn't just another running app. We transformed the entire city into a territorial conquest board, guided by a "Cyberpunk Coach" (The Oracle), natively powered by Gemini 2.5 Flash. Why is this different from what you've seen before? The Oracle speaks to you in real time (Native Audio, without relying on slow TTS). The model silently receives your telemetry: pace, distance, current territory. Each street is a territory to be conquered. Opponents can invade your zones while you run. The AI's responses are tactically relevant: "You are 100 meters away from dominating this area, keep your pace!" Our Technical Stack: We built the bridge between the street and the cloud using: • Flutter/Dart for raw (16kHz PCM) microphone audio capture. • WebSocket server running frenetically on Google Cloud Run. • Background JSON context injection without breaking the Gemini Live audio pipe. • Firestore for global state synchronization and territory control. Spending the last few weeks building the "Real-World Spatial UI" frontier with ultra-low latency conversion agents has been challenging and incredible.

The app is already in production on the Google Play Store and our entire architecture is documented!

Log in or sign up for Devpost to join the conversation.

posted an update —

Neon Protocol V2: Anti-Cheat & Active Territorial Grounding First Runner has just received its most robust update for the Gemini Live Agent Challenge. We are no longer just talking to an AI; we’ve consolidated a "Turf War" infrastructure with ruthless rules and neural consciousness.

KEY UPGRADES (NEW TODAY): Anti-Cheat Engine (FAIR PLAY PROTOCOL): We’ve implemented biological speed limiters and a Red Flag HUD. The Oracle now detects if a user is cheating with a vehicle and blocks territory conquest in real-time — real run or nothing. The Revenge Loop (RE-ENGAGEMENT CYCLES): Deep integration with Firebase for Real-Time Push Notifications. If a rival invades your sector while you're offline, the Neon Protocol summons you for an immediate counter-attack. Hardcore Background GPS: We rebuilt the tracking engine with Native Wakelocks and battery optimization bypass. Tracking is now "implacable," ensuring precise telemetry even during deep sleep on Android. Native Audio 2.5 (Barge-In): Refined PCM Raw Audio pipeline using gemini-2.5-flash-native-audio. The Coach (Oracle) features zero latency and supports natural interruptions (barge-in), reacting instantly to your voice mid-action. Social & Legal Ready: Finalized Facebook Login integration and full compliance with Global Privacy Standards in our new Policy. The asphalt now has rules. The Oracle is watching. The city is your board.

v2 Dev Hub: github.com/egonportolani/First_Runner_V2 Powered by: Gemini 2.5 Flash Native Audio + Firebase Cloud Messaging https://www.youtube.com/watch?v=Xoj2R9uQYS0

Log in or sign up for Devpost to join the conversation.

posted an update —

Protocolo Neon V2: Anti-Cheat & Grounding Territorial Ativo O First Runner acaba de receber sua atualização mais robusta para o Gemini Live Agent Challenge. Não estamos apenas conversando com uma I.A.; consolidamos uma infraestrutura de "Guerra de Territórios" (Turf War) com regras implacáveis e consciência neural.

KEY UPGRADES (NEW TODAY): Anti-Cheat Engine (Protocolo Antifraude): Implementamos limitadores biológicos de velocidade e o sistema de Red Flag no HUD. O Oráculo agora detecta se você está em um veículo e bloqueia a conquista — corrida real ou nada. The Revenge Loop (Ciclo de Revanche): Integração profunda com Firebase para Push Notifications em tempo real. Se um rival invadir seu setor, o Protocolo Neon te convoca para a retomada imediata. Hardcore Background GPS: Reconstruímos a engine de rastreamento com Wakelocks nativos e bypass de otimização de bateria. O tracking agora é persistente e imune ao "deep sleep" do Android. Native Audio 2.5 (Barge-In): Refinamos a pipeline de áudio PCM Raw. O Oráculo tem latência zero e permite interrupções naturais, reagindo instantaneamente à sua voz no meio da ação. Social & Legal Ready: Integração do Facebook Login e conformidade total com a LGPD na nova Privacy Policy. O asfalto agora tem regras. O Oráculo está observando. A cidade é o seu tabuleiro.

v2 Dev Hub: github.com/egonportolani/First_Runner_V2 Powered by: Gemini 2.5 Flash Native Audio + Firebase Cloud Messaging

Log in or sign up for Devpost to join the conversation.