MCPcopy Index your code
hub / github.com/google/adk-samples

github.com/google/adk-samples @main

Chat with this repo
repository ↗ · DeepWiki ↗ · + Follow
6,112 symbols 23,130 edges 1,544 files 3,478 documented · 57% 121 cross-repo links updated today★ 9,84078 open issues
What it actually does AI analysis from the code graph — generated when you open this
loading…
README

Agent Development Kit (ADK) Samples

License

Agent Development Kit Logo

Welcome to the ADK Sample Agents repository! This collection provides ready-to-use agents built on top of Agent Development Kit, designed to accelerate your development process. These agents cover a range of common use cases and complexities, from simple conversational bots to complex multi-agent workflows.

✨ Getting Started

This repo contains ADK sample agents for Python, TypeScript, Go, Java, Kotlin, and Android. Navigate to the Python, TypeScript, Go, Java, Kotlin, and Android subfolders to see language-specific setup instructions, and learn more about the available sample agents.

[!IMPORTANT] The agents in this repository are built using Agent Development Kit (ADK). Before you can run any of the samples, you must have ADK installed. For instructions, please refer to the ADK Installation Guide.

To learn more, check out the ADK Documentation, and the GitHub repositories for each language:

🌳 Repository Structure

├── android
│   ├── agents
│   │   ├── fun-facts
│   └── README.md
├── go
│   ├── agents
│   │   ├── llm-auditor
│   └── README.md
├── java
│   ├── agents
│   │   ├── software-bug-assistant
│   │   └── time-series-forecasting
│   └── README.md
├── kotlin
│   ├── agents
│   │   ├── fun-facts
│   │   └── llm-auditor
│   └── README.md
├── python
│   ├── agents
│   │   ├── academic-research
│   │   ├── antom-payment
│   │   ├── blog-writer
│   │   ├── brand-aligner
│   │   ├── brand-search-optimization
│   │   ├── camel
│   │   ├── customer-service
│   │   ├── data-engineering
│   │   ├── data-science
│   │   ├── deep-search
│   │   ├── financial-advisor
│   │   ├── fomc-research
│   │   ├── gemini-fullstack
│   │   ├── gemma-food-tour-guide
│   │   ├── google-trends-agent
│   │   ├── high-volume-document-analyzer
│   │   ├── image-scoring
│   │   ├── llm-auditor
│   │   ├── machine-learning-engineering
│   │   ├── marketing-agency
│   │   ├── medical-pre-authorization
│   │   ├── personalized-shopping
│   │   ├── plumber-data-engineering-assistant
│   │   ├── RAG
│   │   ├── realtime-conversational-agent
│   │   ├── safety-plugins
│   │   ├── short-movie-agents
│   │   ├── software-bug-assistant
│   │   ├── story_teller
│   │   ├── supply-chain
│   │   ├── travel-concierge
│   │   └── README.md
│   └── README.md
├── typescript
│   ├── agents
│   │   ├── customer_service
│   └── README.md
└── README.md

ℹ️ Getting help

If you have any questions or if you found any problems with this repository, please report through GitHub issues.

🤝 Contributing

We welcome contributions from the community! Whether it's bug reports, feature requests, documentation improvements, or code contributions, please see our Contributing Guidelines to get started.

📄 License

This project is licensed under the Apache 2.0 License - see the LICENSE file for details.

Disclaimers

This is not an officially supported Google product. This project is not eligible for the Google Open Source Software Vulnerability Rewards Program.

This project is intended for demonstration purposes only. It is not intended for use in a production environment.

Extension points exported contracts — how you extend this code

Provider (Interface)
(no doc) [6 implementers]
go/agents/sail-researcher/main.go
ImageVTODisplayProps (Interface)
* Copyright 2026 Google LLC * * Licensed under the Apache License, Version 2.0 (the "License"); * you may not use thi
python/agents/genmedia-for-commerce/frontend/src/pages/GenMediaTV/ImageVTODisplay.tsx
StatusResponse (Interface)
(no doc)
typescript/agents/customer_service/customer_service/tools/tools.ts
Store (Interface)
Store defines the interface for data persistence. It consolidates all data access methods required by the agent and the [2 …
go/agents/navallist/internal/data/store.go
MessageWithAgent (Interface)
(no doc)
python/agents/deep-search/frontend/src/App.tsx
CartItem (Interface)
(no doc)
typescript/agents/customer_service/customer_service/tools/tools.ts
WeatherClient (Interface)
WeatherClient defines the interface for the Open-Meteo API client. [1 implementers]
go/agents/sail-researcher/tools/weather.go
AgentMessage (Interface)
(no doc)
python/agents/deep-search/frontend/src/App.tsx

Core symbols most depended-on inside this repo

get
called by 2631
python/agents/camel/camel/camel_library/interpreter/camel_value.py
get
called by 188
python/agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py
items
called by 154
python/agents/camel/camel/camel_library/interpreter/camel_value.py
run
called by 132
python/agents/camel/camel/camel_agent/camel_agent.py
camel
called by 130
python/agents/camel/camel/camel_library/capabilities/capabilities.py
default
called by 123
python/agents/camel/camel/camel_library/capabilities/capabilities.py
init
called by 98
python/agents/camel/camel/camel_library/interpreter/camel_value.py
search
called by 90
python/agents/personalized-shopping/personalized_shopping/shared_libraries/web_agent_site/envs/web_agent_text_env.py

Shape

Function 3,067
Method 1,886
Class 603
Route 331
Interface 170
Struct 52
TypeAlias 2
FuncType 1

Languages

Python84%
TypeScript10%
Go5%
Java1%

Modules by API surface

python/agents/camel/camel/camel_library/interpreter/camel_value.py257 symbols
python/agents/invoice-processing/invoice_processing/shared_libraries/investigation/investigate_agent_reconst.py147 symbols
python/agents/genmedia-for-commerce/tests/workflows/shared/test_image_utils.py89 symbols
python/agents/invoice-processing/invoice_processing/shared_libraries/alf_engine.py86 symbols
python/agents/genmedia-for-commerce/tests/workflows/shared/test_llm_utils.py76 symbols
python/agents/camel/camel/camel_library/interpreter/interpreter.py72 symbols
python/agents/invoice-processing/tests/test_condition_evaluator.py71 symbols
python/agents/invoice-processing/invoice_processing/shared_libraries/acting/general_invoice_agent.py71 symbols
python/agents/genmedia-for-commerce/tests/workflows/shared/test_gcs_utils.py53 symbols
python/agents/genmedia-for-commerce/tests/workflows/shared/test_person_eval.py47 symbols
python/agents/multiformat-hybrid-rag/tests/unit/document_preprocessing/parser/test_json_parser.py46 symbols
python/agents/genmedia-for-commerce/tests/workflows/shared/test_veo_utils.py46 symbols

Dependencies from manifests, versioned

cloud.google.com/gov0.123.0 · 1×
cloud.google.com/go/authv0.18.0 · 1×
cloud.google.com/go/auth/oauth2adaptv0.2.8 · 1×
cloud.google.com/go/compute/metadatav0.9.0 · 1×
cloud.google.com/go/mapsv1.26.0 · 1×
github.com/FZambia/eaglev0.2.0 · 1×
github.com/GoogleCloudPlatform/opentelemetry-operations-go/detectors/gcpv1.31.0 · 1×
github.com/awalterschulze/gographvizv2.0.3+incompatible · 1×
github.com/aymanbagabas/go-osc52/v2v2.0.1 · 1×
github.com/beorn7/perksv1.0.1 · 1×

Datastores touched

navallistdbDatabase · 1 repos
dbnameDatabase · 1 repos

For agents

$ claude mcp add adk-samples \
  -- python -m otcore.mcp_server <graph>

⬇ download graph artifact