Skip to content

Oppy

Oppy — AI Voice Assistant for Multi-Project Management Oppy is a voice-first AI assistant built on Google's Gemini ecosystem that helps students and professionals juggling multiple projects (school, work, startup) stay o

Code Video Cerebral Valley

Core trick

Wake-word voice loop pulls Gmail and Calendar data, scores urgency across projects, and speaks a ranked briefing via Gemini TTS.

Tags

voiceproductivity

Description

Oppy — AI Voice Assistant for Multi-Project Management Oppy is a voice-first AI assistant built on Google's Gemini ecosystem that helps students and professionals juggling multiple projects (school, work, startup) stay on top of everything. It connects to Gmail and Google Calendar, scores urgency across all projects, and delivers spoken briefings through natural voice conversation powered by Gemini 3 Flash (chat) and Gemini 2.5 Flash TTS (voice). You talk to Oppy like a mentor — it tells you what's urgent, who's waiting, and what to do next. Key features: wake word activation, persistent multi-turn chat, animated SVG avatar with eye tracking, real Gmail/Calendar integration, smart acknowledgment during loading, and a Gemini-inspired UI. Unlike generic chatbots, Oppy is opinionated — it doesn't ask, it tells. "Sophie hasn't heard from you in 6 days, reply tonight." Voice-first means you get briefed while cooking or commuting.
solanathouu/hack-google★ 00 forksJavaScriptCreated Mar 14, 2026 · last push Mar 15, 2026

README excerpt

# Oppy — AI Voice Assistant for Multi-Project Management

Oppy is a voice-first AI assistant built on Google's Gemini ecosystem. It helps students and professionals juggling multiple projects (school, work, startup) stay on top of everything through natural voice conversation.

## What it does

Oppy connects to your Gmail and Google Calendar, analyzes urgency across all your projects, and talks to you like a direct, caring mentor. Ask it about your schedule, your emails, or what to prioritize — it answers with actionable advice.

**Key features:**
- Voice conversation powered by Gemini 3 Flash (chat) and Gemini 2.5 Flash TTS (speech)
- Wake word activation — say "Oppy" to start hands-free
- Animated SVG avatar with eye tracking, blinking, and mouth animation
- Real Gmail and Google Calendar integration
- Expandable project cards with direct action links
- Gemini-inspired UI (Google Sans, white theme, Google color palette)

## Tech stack

| Layer | Tech |
|-------|------|
| Backend | Python, FastAPI, SSE streaming |
| AI | Gemini 3 Flash (chat + function calling), Gemini 2.5 Flash Preview TTS |
| Frontend | React 18, Vite, Web Speech API |
| APIs | Gmail API, Google Calendar API |

## Quick start

### Prerequisites
- Python 3.11+
- Node.js 18+
- A [Google AI API key](https://aistudio.google.com/apikey)

### Setup

```bash
# Clone
git clone https://github.com/solanathouu/hack-google.git
cd hack-google

# Backend
cd backend
pip install -r requirements.txt
echo "GOOGLE_API_KEY=yo

Team