# google/adk-recipes architecture

> Architecture diagram of the GitHub repository google/adk-recipes, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-12). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/adk-recipes
- Repository: https://github.com/google/adk-recipes

## Overview

ADK Recipes is a public collection of runnable Agent Development Kit examples, rather than one integrated application. The main user journey is to browse a recipe category, choose and fork an example, then adapt and run it with an ADK language SDK. The repository README identifies core patterns, deployable community recipes, and installable skill plugins. The graph preserves the central source-index modules; their presence does not imply they form a shared runtime. Links between individual recipes are omitted where excerpts do not establish them.

Main entry points: [`contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py`](https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py) (Hybrid RAG ingestion), [`core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/pipeline.py`](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/pipeline.py) (Product fitting), [`core`](https://github.com/google/adk-recipes/tree/main/core) (Canonical patterns), [`core/python/genmedia-for-commerce/genmedia4commerce/agent.py`](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/agent.py) (Commerce agent)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_core["Core recipes"]
  node_core_catalog["Canonical patterns"]
  node_deep_search["Deep search agent<br/>[agent.py]"]
  node_commerce_agent["Commerce agent<br/>[agent.py]"]
  node_commerce_fit["Product fitting<br/>[pipeline.py]"]
  node_commerce_garment_eval["Garment evaluation<br/>[garment_eval.py]"]
  node_commerce_generation["Fitting generation<br/>[generation.py]"]
  node_commerce_debug["Workflow debugging<br/>[debug_utils.py]"]
  node_commerce_images["Image utilities<br/>[image_utils.py]"]
  node_commerce_llm["LLM utilities<br/>[llm_utils.py]"]
  node_shoe_consistency["Product consistency"]
  node_shoe_validation["Video validation"]
  node_rag_pipeline["RAG ingestion<br/>[pipeline.py]"]
end

subgraph group_contrib["Community recipes"]
  node_contrib_catalog["Deployable agents"]
  node_financial_services["Shared agent services<br/>[services.py]"]
  node_rag_ingest["Hybrid RAG ingestion<br/>[pipeline.py]"]
  node_rag_chunk_index["Chunk and index<br/>[chunk_and_index.py]"]
  node_rag_cleanup["Index cleanup<br/>[cleanup.py]"]
  node_rag_preprocess["Document preprocessing<br/>[preprocess.py]"]
end

subgraph group_plugins["Skill plugins"]
  node_plugin_catalog["Vertical skill plugins"]
end

node_engine(("Recipe user"))
node_adk["ADK SDK"]

node_engine -->|"browse patterns"| node_core_catalog
node_engine -->|"browse agents"| node_contrib_catalog
node_engine -->|"browse skills"| node_plugin_catalog
node_engine -->|"install SDK"| node_adk
node_rag_ingest -->|"calls component"| node_rag_preprocess
node_rag_ingest -->|"calls component"| node_rag_chunk_index
node_rag_ingest -->|"calls component"| node_rag_cleanup
node_commerce_fit -.->|"invoked by"| node_commerce_agent

click node_core_catalog "https://github.com/google/adk-recipes/tree/main/core"
click node_deep_search "https://github.com/google/adk-recipes/blob/main/core/python/deep-search/app/agent.py"
click node_commerce_agent "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/agent.py"
click node_commerce_fit "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/pipeline.py"
click node_commerce_garment_eval "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/garment_eval.py"
click node_commerce_generation "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/generation.py"
click node_commerce_debug "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/debug_utils.py"
click node_commerce_images "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/image_utils.py"
click node_commerce_llm "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/llm_utils.py"
click node_shoe_consistency "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/product_consistency_validation.py"
click node_shoe_validation "https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/video_validation_r2v.py"
click node_rag_pipeline "https://github.com/google/adk-recipes/blob/main/core/python/rag-vector-search/data_ingestion/data_ingestion_pipeline/pipeline.py"
click node_contrib_catalog "https://github.com/google/adk-recipes/tree/main/contrib"
click node_financial_services "https://github.com/google/adk-recipes/blob/main/contrib/python/financial-advisor/app/app_utils/services.py"
click node_rag_ingest "https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py"
click node_rag_chunk_index "https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/chunk_and_index.py"
click node_rag_cleanup "https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/cleanup.py"
click node_rag_preprocess "https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/preprocess.py"
click node_plugin_catalog "https://github.com/google/adk-recipes/tree/main/plugins"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_core_catalog,node_deep_search,node_commerce_agent,node_commerce_fit,node_commerce_garment_eval,node_commerce_generation,node_commerce_debug,node_commerce_images,node_commerce_llm,node_shoe_consistency,node_shoe_validation,node_rag_pipeline,node_engine toneBlue
class node_contrib_catalog,node_financial_services,node_rag_ingest,node_rag_chunk_index,node_rag_cleanup,node_rag_preprocess toneAmber
class node_plugin_catalog toneMint
class node_adk toneIndigo
```

## Components

### Core recipes

- [Canonical patterns](https://github.com/google/adk-recipes/tree/main/core): `core`
- [Deep search agent](https://github.com/google/adk-recipes/blob/main/core/python/deep-search/app/agent.py): `core/python/deep-search/app/agent.py`
- [Commerce agent](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/agent.py): `core/python/genmedia-for-commerce/genmedia4commerce/agent.py`
- [Product fitting](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/pipeline.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/pipeline.py`
- [Garment evaluation](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/garment_eval.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/garment_eval.py`
- [Fitting generation](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/generation.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/product_enrichment/product_fitting/generation.py`
- [Workflow debugging](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/debug_utils.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/debug_utils.py`
- [Image utilities](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/image_utils.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/image_utils.py`
- [LLM utilities](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/llm_utils.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/shared/llm_utils.py`
- [Product consistency](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/product_consistency_validation.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/product_consistency_validation.py`
- [Video validation](https://github.com/google/adk-recipes/blob/main/core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/video_validation_r2v.py): `core/python/genmedia-for-commerce/genmedia4commerce/workflows/spinning/r2v/shoes/video_validation_r2v.py`
- [RAG ingestion](https://github.com/google/adk-recipes/blob/main/core/python/rag-vector-search/data_ingestion/data_ingestion_pipeline/pipeline.py): `core/python/rag-vector-search/data_ingestion/data_ingestion_pipeline/pipeline.py`

### Community recipes

- [Deployable agents](https://github.com/google/adk-recipes/tree/main/contrib): `contrib`
- [Shared agent services](https://github.com/google/adk-recipes/blob/main/contrib/python/financial-advisor/app/app_utils/services.py): `contrib/python/financial-advisor/app/app_utils/services.py`
- [Hybrid RAG ingestion](https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py): `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py`
- [Chunk and index](https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/chunk_and_index.py): `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/chunk_and_index.py`
- [Index cleanup](https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/cleanup.py): `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/cleanup.py`
- [Document preprocessing](https://github.com/google/adk-recipes/blob/main/contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/preprocess.py): `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/components/preprocess.py`

### Skill plugins

- [Vertical skill plugins](https://github.com/google/adk-recipes/tree/main/plugins): `plugins`

### Other components

- **Recipe user**
- **ADK SDK**

## Connections

- Recipe user → Canonical patterns: browse patterns (evidence: `README.md`)
- Recipe user → Deployable agents: browse agents (evidence: `README.md`)
- Recipe user → Vertical skill plugins: browse skills (evidence: `README.md`)
- Recipe user → ADK SDK: install SDK (evidence: `README.md`)
- Hybrid RAG ingestion → Document preprocessing: calls component (evidence: `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py`)
- Hybrid RAG ingestion → Chunk and index: calls component (evidence: `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py`)
- Hybrid RAG ingestion → Index cleanup: calls component (evidence: `contrib/python/multiformat-hybrid-rag/data_ingestion_pipeline/data_ingestion_pipeline/pipeline.py`)
- Product fitting → Commerce agent: invoked by
