Google Adk Masterclass

🌟 Google ADK Masterclass

View Full Course

[](https://arjunprabhulal.com/courses/adk-masterclass-hands-on-series/) [](https://google.github.io/adk-docs/) [](LICENSE) [](https://twitter.com/arjunprabhulal)

📖 Overview

Build production-ready AI agents with Google's Agent Development Kit (ADK). This hands-on masterclass covers everything from basic setup to advanced topics like multi-agent systems, memory management, and custom integrations.

What this project offers:

• 📚 Step-by-step tutorials progressing from fundamentals to advanced techniques
• 💻 Modular, ready-to-run code examples with minimal setup
• 🏗️ Reference architectures for building real-world AI agent applications

▶️ Demo

💡 Why This Exists

Learn ADK through hands-on projects. Each module pairs concepts with working code, progressing from basics to advanced multi-agent patterns.

🎯 Who Is This For

| If you are... | This is for you | |---------------|-----------------| | 🆕 New to AI agents | Start from Module 1, learn foundations first | | 🔄 Coming from LangChain/CrewAI | Jump to Module 4+ for ADK-specific patterns | | 🏗️ Building production systems | Focus on Modules 16-20 for state, memory, events | | 🔧 Integrating tools/APIs | Modules 7-14 cover built-in and custom tooling |

✨ Features

• 📋 Comprehensive curriculum — 20 modules covering agents, workflows, tools, memory, and integrations
• 🖥️ Multiple interfaces — CLI, Web UI, and programmatic approaches for every example
• ⚙️ Production patterns — state management, callbacks, artifacts, and event streaming
• 🔧 Extensible tooling — built-in tools, custom functions, OpenAPI, and MCP integrations
• 📜 MIT licensed — free to use, modify, and deploy for personal or commercial projects

📚 Modules

🏁 Foundations

| # | Topic | Description | Blog | |---|--------|-------------|------| | 01 | [Getting Started](./01-getting-started/) | Introduction to ADK, environment setup, first agent | Read | | 02 | [Setting Up Agents](./02-setting-up-agent/) | CLI, Web, and Programmatic setup methods | Read | | 03 | [Visual Builder](./03-visual-builder/) | No-code agent building with Visual Builder | Read |

🤖 Agent Types

| # | Topic | Description | Blog | |---|--------|-------------|------| | 04 | [LLM Agents](./04-llm-agents/) | Building intelligent LLM-powered agents | Read | | 05 | [Workflow Agents](./05-workflow-agents/) | Sequential, Parallel, and Loop patterns | Read | | 06 | [Multi-Agent Systems](./06-multi-agent-systems/) | Agent orchestration and collaboration | Read |

🔧 Tools & Integrations

| # | Topic | Description | Blog | |---|--------|-------------|------| | 07 | [Built-in Tools](./07-built-in-tools/) | Google Search, Code Executor | Read | | 08 | [Vertex AI RAG](./08-vertex-ai-rag/) | RAG Engine integration | Read | | 09 | [Vertex AI Search](./09-vertex-ai-search/) | Enterprise search integration | Read | | 10 | [Custom Function Tools](./10-custom-function-tools/) | Building custom Python tools | Read | | 11 | [OpenAPI Tools](./11-openapi-tools/) | REST API integration | Read | | 12 | [Multi-Tool Agent](./12-multi-tool-agent/) | Combining multiple tools | Read | | 13 | [Third-Party MCP Tools](./13-third-party-mcp-tools/) | GitHub, Firecrawl integration | Read | | 14 | [MCP Toolbox for Databases](./14-mcp-toolbox/) | Database integration with MCP Toolbox | Read |

Protocols

| # | Topic | Description | Blog | |---|--------|-------------|------| | 15 | [Model Context Protocol](./15-mcp-deep-dive/) | MCP architecture and patterns | Read |

⚙️ Core Components

| # | Topic | Description | Blog | |---|--------|-------------|------| | 16 | [Session, State & Memory](./16-sessions-state-memory/) | Conversation history and state management | Read | | 17 | [Context Management](./17-context-management/) | Caching and compaction | Read | | 18 | [Callbacks](./18-callbacks/) | Intercepting agent behavior | Read | | 19 | [Artifacts](./19-artifacts/) | File and data handling | Read | | 20 | [Events](./20-events/) | Event streaming and debugging | Read |

📋 Prerequisites

For most modules:

• Python 3.10+
• Gemini API key from AI Studio

For Vertex AI modules (08, 09, 18):

• See [GCP Setup Guide](./docs/GCP_SETUP.md) for detailed instructions

🚀 Quick Start

# Clone the repository
git clone https://github.com/arjunprabhulal/google-adk-masterclass.git
cd google-adk-masterclass

# Set up environment
echo "GOOGLE_API_KEY=your-api-key-here" > .env

Option 1: Using uv (Recommended)

# Install uv if you haven't already
curl -LsSf https://astral.sh/uv/install.sh | sh

# Create virtual environment and install dependencies
uv venv && source .venv/bin/activate
uv pip install -r requirements.txt

# Run your first agent
cd 01-getting-started
adk web

Option 2: Using pip

# Create virtual environment
python -m venv .venv
source .venv/bin/activate  # On Windows: .venv\Scripts\activate

# Install dependencies
pip install -r requirements.txt

# Run your first agent
cd 01-getting-started
adk web

🔗 Resources

• ADK Documentation
• ADK GitHub Repository
• Course Homepage
• Author's Blog

🤝 Contributing

Contributions are welcome! Whether it's:

• 🐛 Bug fixes
• 📝 Documentation improvements
• 💡 New module suggestions
• 🌟 Sharing your projects built with this masterclass

Please open an issue first to discuss what you'd like to change.

👤 Author

Arjun Prabhulal

• 🌐 Website: arjunprabhulal.com
• 💻 GitHub: @arjunprabhulal
• 🐦 Twitter: @arjunprabhulal

📄 License

This project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.

---

⭐ If you find this helpful, please star this repository and share with others!

Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: arjunprabhulal
• Source: arjunprabhulal/google-adk-masterclass
• License: MIT
• Homepage: https://arjunprabhulal.com/courses/adk-masterclass-hands-on-series/

Install and usage instructions live in the source repository linked above.