From Chaos to Culinary Excellence
Built for the Google Cloud Run Hackathon 2025
Live Demo | Documentation | Architecture
Cooking can be chaotic — from figuring out what to make to juggling timers and ingredients. Piatto is your AI-powered culinary assistant, transforming that chaos into creativity.
With Piatto, you can:
- 🍅 Generate personalized recipes from your available ingredients
- 🥄 Get real-time, step-by-step cooking guidance
- 🗣️ Ask contextual cooking questions (hands-free with voice)
- ⏱️ Automate timers and measurements, all in one interface
Built for the Google Cloud Run Hackathon, Piatto demonstrates:
- Scalable serverless architecture
- Multi-agent AI orchestration with Google ADK
- Global edge delivery for lightning-fast performance
- AI Recipe Generation — Create recipes from ingredients (text or image input)
- Image Analysis — Upload photos; let AI identify ingredients & suggest dishes
- Interactive Cooking Chat — Get substitutions, troubleshoot mistakes, and more
- Step-by-Step Instructions — Context-aware cooking with automated timers
- Recipe Library — Save, organize, and share your favorites
- Multilingual Support — i18next-powered (English & German)
- Voice Assistant — Hands-free cooking with optional voice commands
- Serverless Auto-Scaling with Google Cloud Run
- Multi-Agent AI powered by Google ADK
- Global Edge Delivery via Cloud CDN (150+ PoPs)
- Secure & Scalable: VPC, Cloud SQL, OAuth 2.0, managed SSL
- Automated CI/CD with GitHub Actions & Artifact Registry
- React 19 (Hooks & Functional Components)
- Vite 7 for ultra-fast builds
- Tailwind CSS 4 + custom theme tokens
- React Router 6 (protected routes)
- i18next for localization
- Axios (cookie-based auth)
- Framer Motion & Lottie for animations
- FastAPI with
async/await - Uvicorn ASGI server
- SQLAlchemy 2.0 async ORM (
aiomysql+ SQLite fallback) - Pydantic v2, Authlib, JWT, bcrypt
- APScheduler for background tasks
- Google ADK v1.16.0 with Gemini 2.5 Flash foundation model
- Multi-Agent Architecture:
- 🖼️ Image Analyzer — Ingredient recognition
- 🍽️ Recipe Agent — Personalized recipe generation
- 📋 Instruction Agent — Step-by-step cooking guide
- 🎨 Image Agent — Visual content for recipes
- 💬 Chat Agent — Conversational Q&A
- Multi-modal inputs: Text + Image
- Structured outputs: Pydantic schema validation
Google Cloud Platform Components
- Cloud Run — Serverless containers for frontend & backend
- Cloud SQL (MySQL) — Managed database with VPC connector
- Cloud Storage — Media + static assets
- Cloud CDN — 150+ PoPs for global caching
- Load Balancer + Managed SSL — Secure HTTPS endpoints
- Artifact Registry — Image hosting
- Secret Manager — Encrypted credential storage
- Docker multi-stage builds (Uvicorn + Nginx)
- GitHub Actions — Build, test, deploy pipelines
- Automated Deployments to Cloud Run
- ESLint 9 for linting & code quality
- Managed SSL Certificates for secure HTTPS
[Client]
↓
[Global HTTPS Load Balancer]
↳ /api/* → Cloud Run (FastAPI) → Cloud SQL + Cloud Storage
↳ /assets/* → Cloud CDN → Cloud Storage
↳ /* (SPA) → Cloud CDN → Cloud Run (Nginx)
Caching Strategy
/assets/*: Cache-Control:public, max-age=31536000, immutable/index.html: Cache-Control:no-cache- SPA routes: Nginx fallback with
try_files /index.html
Category: AI Agents (Google Cloud Run Hackathon 2025)
- 🚀 Serverless at Scale: Auto-scaling from 0→∞ with Cloud Run
- 🧠 Multi-Modal AI: Text + image with Gemini 2.5 Flash
- 🌎 Global Delivery: CDN-backed 150+ PoPs
- 🔒 Secure by Design: OAuth 2.0, Secret Manager, VPC
- ⚡ DevOps Excellence: Automated CI/CD pipelines
- 💸 Cost-Efficient: Pay-per-use serverless model
Built with passion by a team dedicated to making cooking accessible, enjoyable, and intelligent.
This project was developed for the Google Cloud Run Hackathon 2025.
© 2025 Piatto Team. All rights reserved.
- Google Cloud Platform — Serverless infrastructure
- Google ADK — Multi-agent orchestration
- Gemini 2.5 Flash — Foundation model
- Cloud Run Hackathon — For the inspiration & opportunity
