ag-ui-adk-grounding-app

# 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](https://makersuite.google.com/app/apikey)
- **CopilotKit License Key** - [Get it here](https://cloud.copilotkit.ai/)
- **Package Manager** - npm, pnpm, yarn, or bun

## 🚀 Quick Start

### 1. Clone and Install

```bash
# 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