# adk-samples

**Repository Path**: mirrors_google/adk-samples

## Basic Information

- **Project Name**: adk-samples
- **Description**: A collection of sample agents built with Agent Development (ADK) 
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-04-11
- **Last Updated**: 2026-10-03

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# <img src="https://raw.githubusercontent.com/google/adk-docs/main/docs/assets/agent-development-kit.png" alt="Agent Development Kit Logo" width="30"> ADK Recipes

[![License](https://img.shields.io/badge/License-Apache_2.0-blue.svg)](LICENSE)


Welcome. This is a public collection of ADK recipes — small,
runnable agents that show how to solve real problems with the
[Agent Development Kit](https://adk.dev). 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/`](./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/`](./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/`](./plugins/)** — domain-specific vertical skill plugins
  (e.g., `plugins/retail/product-search`, `plugins/retail/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](https://adk.dev/get-started). Language
SDKs:

- [ADK Python](https://github.com/google/adk-python)
- [ADK TypeScript](https://github.com/google/adk-js)
- [ADK Go](https://github.com/google/adk-go)
- [ADK Java](https://github.com/google/adk-java)
- [ADK Kotlin](https://github.com/google/adk-kotlin)

## Contributing a recipe

Start with the [Recipe Checklist](./docs/recipe-checklist.md) —
one page, everything you need to ship. If you want the full
context and tooling reference, the
[Recipe Handbook](./docs/recipe-handbook/README.md) 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/`](./.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](https://github.com/google/adk-recipes/issues).

## License

Apache 2.0 — see [LICENSE](./LICENSE).

## Disclaimer

Not an officially supported Google product. Not eligible for the
[Google OSS Vulnerability Rewards Program](https://bughunters.google.com/open-source-security).
Recipes are for demonstration and as starting points, not
production use.