Full-stack AI agent with Google ADK, Google Maps & Search grounding, CopilotKit, and AG-UI

Full-Stack AI Agent with Google ADK, CopilotKit & AG-UI

A complete AI agent application with Google Search and Maps grounding capabilities, built with Google's Agent Development Kit (ADK), CopilotKit, and AG-UI protocol.

✨ Features

• 🔍 Google Search Grounding - Real-time web search with source attribution
• 🗺️ Google Maps Grounding - Location-based queries, directions, and place information
• 🎨 Dynamic Theme - Agent can change application colors
• 📝 Proverbs Management - Add/remove proverbs through conversation
• 🌦️ Weather Cards - Generative UI components for weather information
• 💬 Real-time Chat - Powered by AG-UI protocol and CopilotKit

🏗️ Architecture

This project demonstrates the Agent-as-Tool Pattern for integrating Google's grounding tools:

┌─────────────────┐    AG-UI Protocol    ┌─────────────────┐
│   Next.js UI    │◄──────────────────►│   ADK Agent      │
│   (CopilotKit)  │                    │   (Python)       │
└─────────────────┘                    └─────────────────┘
                                               │
                                               ▼
                                       ┌─────────────────┐
                                       │  Grounding      │
                                       │  - Search Agent │
                                       │  - Maps Agent   │
                                       └─────────────────┘

📋 Prerequisites

• Node.js 18+
• Python 3.12+
• Google Cloud Account with billing enabled
• Google AI Studio API Key - Get it here
• CopilotKit License Key - Get it here
• Package Manager - npm, pnpm, yarn, or bun

🚀 Quick Start

1. Clone and Install

# Clone the repository
git clone <your-repo-url>
cd ag-ui-adk-app

# Install Node.js dependencies
npm install

# Install Python dependencies (creates virtual environment)
npm ru