A curated resource for building, deploying, and scaling AI agents using Google's Agent Development Kit (ADK). Includes templates, best practices, and production-ready examples for research, business, automation, education, content creation, and more.
- 🎯 What This List Solves
- What is Google's Agent Development Kit (ADK)?
- 🏆 Featured Projects
- 🚀 Templates & Starters
- 🌟 Community Excellence
- 📚 Learning Resources
- 🎯 Official Examples
- 🚀 Getting Started / Installation
- 🙏 Credits and Acknowledgements
- ⭐ Call to Action
Welcome to Awesome ADK Agents👋👋
From simple helpers to complex multi-agent systems, this repository will serve as a comprehensive resource for anyone interested in building AI agents using Google's Agent Development Kit (ADK).
Building production-ready AI agents with Google's ADK shouldn't require starting from scratch or piecing together fragmented tutorials. This curated collection addresses three critical challenges that slow down agent development:
- Problem: Most developers waste weeks searching for reliable starting points and end up with toy examples that don't scale
- Solution: Curated, battle-tested templates and real-world implementations you can actually build upon
- Problem: Tutorials teach basics, but deploying robust, scalable agents requires understanding integration patterns, error handling, and deployment strategies
- Solution: Production-ready examples with complete implementation details, from development to deployment
- Problem: The jump from "Hello World" tutorials to building meaningful solutions feels overwhelming
- Solution: Progressive examples that bridge theory and practice, showing how real developers solve actual problems
Whether you're a beginner looking for solid foundations or an experienced developer seeking proven patterns, this repository eliminates the trial-and-error phase and accelerates your path to production-ready agents.
Agent Development Kit (ADK) is a flexible and modular framework for developing and deploying AI agents. While optimized for Gemini and the Google ecosystem, ADK is model-agnostic, deployment-agnostic, and is built for compatibility with other frameworks. ADK was designed to make agent development feel more like software development, to make it easier for developers to create, deploy, and orchestrate agentic architectures that range from simple tasks to complex workflows.
-
Rich Tool Ecosystem: Utilize pre-built tools, custom functions, OpenAPI specs, or integrate existing tools to give agents diverse capabilities, all for tight integration with the Google ecosystem.
-
Code-First Development: Define agent logic, tools, and orchestration directly in Python for ultimate flexibility, testability, and versioning.
-
Modular Multi-Agent Systems: Design scalable applications by composing multiple specialized agents into flexible hierarchies.
-
Deploy Anywhere: Easily containerize and deploy agents on Cloud Run or scale seamlessly with Vertex AI Agent Engine.
My showcase agents demonstrating production-ready ADK implementations
| Agent Name | Category/Domain | Short Description | Badges |
|---|---|---|---|
| Job Interview Agent | HR/Recruitment | AI-powered interview assistant with calendar integration and real-time feedback | ⭐🏭🟡 |
| Education Path Advisor for India | Education/Career Guidance | Multi-agent AI advisor for Indian students/parents: personalized pathways, stepwise plans, risk analysis, and region/reservation-aware guidance | ⭐🟡 |
| Academic Research Assistant | Research/Academia | Multi-agent literature review assistant with profile analysis, robust paper search (with SerpAPI fallback), and personalized research synthesis | 🟡 |
| Project Manager Agent | Productivity/Management | Automated project management with task tracking and progress monitoring | 🟡 |
| Learning Content System (WIP) | Information Retrieval | Enhanced RAG implementation with vector search and context optimization using pgvector and PostgreSQL | 🚧🟡 |
Badge Legend:
- ⭐ My Showcase - Featured portfolio projects
- 🏭 Production-Ready - Has deployment code and infrastructure
- 🔥 Community Pick - Outstanding community contributions
- 🚧 In Development - Work in progress
- 📚 Learning Resource - Educational/tutorial content (official examples are demo/educational only)
- 🟢🟡🔴 Difficulty: Beginner, Intermediate, Advanced
Ready-to-use templates to kickstart your ADK projects
- 🚀 GoogleCloudPlatform/agent-starter-pack 🏭🟢 - Production-ready Generative AI Agent templates for Google Cloud with ADK samples, comprehensive deployment infrastructure
- 🔥 Gemini Fullstack ADK Quickstart 🏭🟡⭐ - The gold standard: Complete fullstack research agent with React frontend, human-in-the-loop workflows, autonomous research pipelines, and Cloud Run deployment
- 📱 kkdai/linebot-adk 🏭🟢 - LINE Bot template with Docker, Cloud Run deployment, and security configurations
- 🌐 phamvuhoang/google-adk-nextjs-starter 🟢 - Next.js starter template for Google ADK projects with Angular frontend
- 🎨 abhishekkumar35/google-adk-nocode 🟢 - Visual, no-code interface for creating AI agents (supports cloud and local Ollama models)
Outstanding community projects showcasing ADK capabilities
- 🔥 Parth0248/Forkcast 🏭🟡 - Multi-agent AI system for collaborative dining decisions with deployed webapp, technical reports, and Cloud Run deployment
- 🚀 kweinmeister/agentic-trading 🏭🔴 - Multi-agent trading system with risk management, featuring AlphaBot and RiskGuard agents with complete A2A protocol implementation and production deployment
- 📊 vladkol/CRM Data Q&A Agent 🏭🔴 - Multi-agentic system with Advanced RAG and NL2SQL over Salesforce Data, "Run on Google Cloud" deployment
- 🏙️ M-JULIANI/nyc-monitor 🟡🏭🔥 - AI-powered urban intelligence system for real-time NYC event analysis and reporting with multi-agent architecture and automated Google Slides reports
- 🔌 RubensZimbres/A2A_ADK_MCP 🔴 - Multi-Agent Systems using Google's ADK + A2A + MCP
- 🎤 bhancockio/Voice-Enabled-Agent 🟡 - Speech-to-text and voice interaction capabilities with G-Calendar integration and comprehensive setup documentation
- 🔗 serkanyasr/mcp-agent-tool-adapter 🟡 - Converts MCP tools into Google ADK or LangGraph agents with streaming FastAPI/CLI
- 🔧 codeninja/Mongoose Migration Agent System 🔴🔥 - Multi-agent system for automated Mongoose database migration (v6→v8) with specialized agents and MCP integration
- 🛠️ VidyutChakrabarti/AgentFlux 🏭🔴🔥 - Agent engineering platform with interactive playgrounds, graph visualization, automated refinement loops, and fine-tuned models for prompt optimization
- 💰 mtwn105/zerodha-mcp 🟡 - Zerodha MCP Server & Client integrating Google ADK for financial applications
- 📈 sudsk/tradesage-mvp 🏭🟡 - Multi-agent trading hypothesis analysis system with 6 specialized agents and Cloud Run deployment
✈️ AashiDutt/Google-Agent-Development-Kit-Demo 🟢 - ADK-powered travel planner- 📊 jenyss/google-adk-data-visualization-agent 🟡 - Data visualization agent built with Google ADK
- 🏥 Ahsan462aggk/Medical_Search_Pro_Agent 🟡🏭 - Multi-agent biomedical research system with PubMed search, analysis, and email delivery
- 🧠 IhateCreatingUserNames2/Cognisphere 🔴 - AI agent development framework built on Google's ADK
- 🎨 bhancockio/YouTube-Thumbnail-Agent 🟢 - Automated thumbnail generation and optimization
- 📊 AI Trends Analysis Pipeline 🟡🔥 - Comprehensive AI analysis pipeline using Exa Search, Tavily Search, Firecrawl and Nebius AI
- 📁 Job Finder Agent 🟡 - Sequential Agent using Mistral OCR, Linkup API and Nebius AI
- 📧 Email ADK Agent 🟢 - Email management and automation agent using Resend API
- 📦 arjunprabhulal/MCP-Gemma-3-Agent 🟡 - Gemma 3 leveraged by Ollama, MCP Youtube Search
Comprehensive guides, tutorials, and educational content
- 📚 ADK Crash Course by Brandon Hancock 🟢📚 - Fundamentals of ADK, from basics to advanced workflows and multi-agent systems with Youtube tutorial
- 📚 A2A Crash Course by Brandon Hancock 🟡📚 - Comprehensive guide to building agent-to-agent (A2A) communication using ADK with Youtube tutorial
- 📚 chongdashu/adk-made-simple 🟢📚 - From basics to A2A integration with real world applications and projects
- 📚 theailifestyle/google-adk-demos 🟢📚 - Collection of practical demos showcasing various ADK features
- 🧪 Google ADK Codelabs ⭐📚 - Interactive, guided tutorials with hands-on coding exercises from Google
- 📖 chongdashu/adk-mcp-a2a-crash-course 🟡📖🔥 - Complete multi-agent system with ADK + A2A + MCP integration, featuring Notion and ElevenLabs with full architecture, testing, and YouTube tutorial
- 📖 mongodb-developer/MongoDB-ADK-Agents 🟡📖💡 - Official MongoDB grocery shopping agent implementation with Vector Search, complete dataset, and step-by-step setup - companion repository for the MongoDB Atlas tutorial
- 📖 datascalehq/datascale 🟡📖🔥 - Multi-agent documentation builder with planner and writer agents that automatically analyze codebases and generate structured knowledge bases - companion repository for the codebase documentation article
- 📖 meteatamel/adk-demos 🟢📖 - Collection of demos and tutorials for Google's Agent Development Kit
- 📖 sokart/adk-walkthrough 🟡📖 - Step-by-step guides and examples using the open-source Python ADK framework
- 📖 bhancockio/RAG-Agent-Tutorial 🟡📖 - Complete RAG implementation with ADK and Vertex AI with YouTube tutorial
- 📖 bhancockio/MCP Integration Tutorial 🟡📖 - Model Context Protocol (both local and remote) with ADK with Youtube tutorial
- 📝 From Zero to Multi-Agents: A Beginner's Guide to Google ADK 🟢📝 - Step-by-step beginner guide by Dr Sokratis Kartakis
- 📝 Choosing the Right Deployment Path for Your Google ADK Agents 🟡📝🏭 - Official Google Cloud guide comparing deployment strategies (Cloud Run vs Vertex AI vs GKE) for production ADK agents
- 📝 Build a Python AI Agent in 15 Minutes with Google ADK and MongoDB Atlas Vector Search 🟡📝💡 - Practical tutorial building a grocery shopping agent with ADK, MongoDB Vector Search, and Gemini 2.0 Flash
- 📝 Building Next-Gen AI Agents with Google ADK, MCP, RAG and Ollama 🟡📝💡 - Comprehensive tutorial on building multi-agent chatbots integrating ADK + MCP + RAG + Ollama with step-by-step code and architecture diagrams
- 📝 Building a Knowledge Base from Your Codebase using Google ADK 🟡📝🔥 - Complete guide to building multi-agent documentation systems that automatically analyze codebases and generate structured knowledge bases using ADK's planner and writer agents
- 🎥 Introducing Agent Development Kit (ADK) 🟢🎥 - 3-minute product overview shown at launch
- 🎥 Getting started with ADK 🟢🎥 - 12-minute "hello-world" coding session from pip install to first agent
- 🎥 Google Launches an Agent SDK – ADK Deep Dive 🟡🎥 - Independent review comparing ADK to other agent SDKs
Google ADK samples repository - educational and demonstration purposes only
⚠️ Important: These are official Google examples for learning and demonstration purposes only. They are not intended for production use without significant modification. See the ADK samples disclaimer.
- 📚 Academic Research Agent 🟡📚 - Comprehensive research assistant for academic papers and citations
- 📊 Data Science Agent 🟡📚 - Automated data analysis and visualization workflows
- 📈 Time Series Forecasting Agent 🔴📚 - Advanced predictive analytics for time-based data
- 🏛️ FOMC Research Agent 🟡📚 - Federal Reserve meeting analysis and insights
- 🛡️ Auto Insurance Agent 🟡📚 - Automated insurance claim processing and customer support
- 🎯 Brand Search Optimization 🟡📚 - SEO and brand visibility enhancement for products in retail websites
- 📞 Customer Service Agent 🟡📚 - Multi-channel customer support automation
- 💰 Financial Advisor 🟡📚 - Personalized financial planning and investment advice
- 🛒 Personalized Shopping 🟡📚 - AI-driven product recommendations and shopping assistance
- 📱 Marketing Agency 🟡📚 - Comprehensive digital marketing campaign management
✈️ Travel Concierge 🟡📚 - Intelligent travel planning and booking assistance
- 🐛 Software Bug Assistant 🟡📚 - Automated bug detection and resolution suggestions to help IT Support and SDE
- 🔍 LLM Auditor 🔴📚 - Model performance evaluation and optimization
- 📚 RAG Systems 🔴📚 - Advanced Retrieval-Augmented Generation implementations
Follow these steps to set up the repository and start working with ADK agents:
git clone https://github.com/[YOUR_USERNAME]/awesome-adk-agents.git
cd awesome-adk-agents- Navigate to an Agent Directory: Choose either a custom agent or an example:
# For custom agents
cd my-adk-agents/job-interview-agent/- Follow Agent-Specific Instructions: Each agent has its own
README.mdwith detailed setup and usage instructions.
Generally, the setup involves:
- Creating a Python virtual environment
python -m venv .venv
source .venv/bin/activate # macOS/Linux
.venv\Scripts\activate # Windows- Installing dependencies
pip install -r requirements.txt- Common Commands of ADK:
Usage: adk [OPTIONS] COMMAND [ARGS]...
Agent Development Kit CLI tools.
Options:
--help Show this message and exit.
Commands:
web Starts a FastAPI server with Web UI for agents(Mostly used)
api_server Starts a FastAPI server for agents
create Creates a new app in the current folder with prepopulated agent...
deploy Deploys agent to hosted environments
eval Evaluates an agent given the eval sets
run Runs an interactive CLI for a certain agent- Read Each Agent's README: Setup requirements and usage patterns vary between agents
- Check Dependencies: Install agent-specific requirements before running
- Environment Variables: Many agents require specific environment variables for API keys
- Test in Development: Always test agents in a safe environment before production use
- 🐛 Bug Reports: Found an issue with an existing agent?
- 💡 Feature Requests: Have ideas for new agents or improvements?
- 📚 Documentation: Spotted unclear or missing documentation?
For detailed contribution guidelines, coding standards, and submission requirements, please see CONTRIBUTING.md.
Remember: All contributions should follow Google ADK best practices and include appropriate documentation.
For general ADK questions, you may also want to check:
This repository wouldn't be possible without the amazing work and contributions from:
- Google ADK Team: For creating an exceptional framework for AI agent development
- Google Agent Garden: For providing comprehensive, production-quality agent examples
- Brandon Hancock: For creating educational ADK content and tutorials that help developers learn
Special thanks to the developers and researchers pushing the boundaries of AI agent capabilities with Google's tools and technologies.
If you find this repository useful for your AI agent development journey, please consider:
- ⭐ Starring this repository to help others discover it
- 🔗 Sharing it with fellow developers and AI enthusiasts
- 🤝 Contributing your own agents or improvements
- 📢 Spreading the word about Google ADK and its capabilities
Together, we can build an amazing collection of AI agents that showcase the power and versatility of Google's Agent Development Kit!
Happy agent building! 🤖✨