ADK Recipes

Welcome. This is a public collection of ADK recipes — small, runnable agents that show how to solve real problems with the Agent Development Kit. Fork one as the starting point for your own project, or browse the collection to learn the patterns.

Whether you're building a customer service bot, a research agent, or something entirely new, the recipes here give you a working foundation instead of a blank page.

Try a recipe

Recipes live in three places:

• core/ — canonical patterns curated by the agents-cli team. Small, focused recipes that teach one thing well (OAuth flows, session memory, guardrails, RAG patterns).
• contrib/ — community-contributed and vertical deployable agents (e.g., contrib/python/retail-product-search, contrib/python/retail-virtual-tryon) that deploy to Gemini Enterprise Agent Platform (Agent Engine), Gemini Enterprise (GE), Cloud Run, and Agent Garden.
• plugins/ — domain-specific vertical skill plugins (e.g., plugins/retail/skills/product-search, plugins/retail/skills/virtual-tryon) that ship as installable AI coding-assistant / GE Desktop skills (SKILL.md and EVAL.yaml).

Each recipe has its own README.md with setup and run instructions.

Prerequisites

Install ADK from the ADK Get Started guide. Language SDKs:

• ADK Python
• ADK TypeScript
• ADK Go
• ADK Java
• ADK Kotlin

Contributing a recipe

Start with the Recipe Checklist — one page, everything you need to ship. If you want the full context and tooling reference, the Recipe Handbook has the deep detail.

Repo skills — the AI coding-assistant helpers used to build this repo (recipe scaffolding, manifest generation, pyproject alignment, and more) — live in .agents/skills/. Not to be confused with plugins, which are recipes shipped to users under plugins/<vertical>/<solution>/.

Getting help

Open a GitHub issue at github.com/google/adk-recipes/issues — for bugs, questions, or to propose a new contrib/ recipe.

License

Apache 2.0 — see LICENSE.

Disclaimer

Not an officially supported Google product. Not eligible for the Google OSS Vulnerability Rewards Program. Recipes are for demonstration and as starting points, not production use.