README
¶
Agent Development Kit (ADK) for Go
An open-source, code-first Go toolkit for building, evaluating, and deploying sophisticated AI agents with flexibility and control.
Important Links: Docs & Samples & Python ADK & Java ADK & ADK Web.
Agent Development Kit (ADK) is a flexible and modular framework that applies software development principles to AI agent creation. It is designed to simplify building, deploying, and orchestrating agent workflows, from simple tasks to complex systems. While optimized for Gemini, ADK is model-agnostic, deployment-agnostic, and compatible with other frameworks.
This Go version of ADK is ideal for developers building cloud-native agent applications, leveraging Go's strengths in concurrency and performance.
✨ Key Features
- Idiomatic Go: Designed to feel natural and leverage the power of Go.
- Rich Tool Ecosystem: Utilize pre-built tools, custom functions, or integrate existing tools to give agents diverse capabilities.
- Code-First Development: Define agent logic, tools, and orchestration directly in Go for ultimate flexibility, testability, and versioning.
- Modular Multi-Agent Systems: Design scalable applications by composing multiple specialized agents.
- Deploy Anywhere: Easily containerize and deploy agents, with strong support for cloud-native environments like Google Cloud Run.
🚀 Installation
To add ADK Go to your project, run:
go get google.golang.org/adk
📄 License
This project is licensed under the Apache 2.0 License - see the LICENSE file for details.
The exception is internal/httprr - see its LICENSE file.
Directories
¶
| Path | Synopsis |
|---|---|
|
Package agent provides entities to build agents using ADK.
|
Package agent provides entities to build agents using ADK. |
|
llmagent
Package llmagent provides an LLM-based agent.
|
Package llmagent provides an LLM-based agent. |
|
remoteagent
Package remoteagent allows to use a remote ADK agents.
|
Package remoteagent allows to use a remote ADK agents. |
|
workflowagents/loopagent
Package loopagent provides an agent that repeatedly runs its sub-agents for a specified number of iterations or until termination condition is met.
|
Package loopagent provides an agent that repeatedly runs its sub-agents for a specified number of iterations or until termination condition is met. |
|
workflowagents/parallelagent
Package parallelagent provides an agent that runs its sub-agents in parallel.
|
Package parallelagent provides an agent that runs its sub-agents in parallel. |
|
workflowagents/sequentialagent
Package sequentialagent provides an agent that runs its sub-agents in a sequence.
|
Package sequentialagent provides an agent that runs its sub-agents in a sequence. |
|
Package artifact provides a service for managing artifacts.
|
Package artifact provides a service for managing artifacts. |
|
gcsartifact
Package gcsartifact provides a Google Cloud Storage (GCS) artifact.Service.
|
Package gcsartifact provides a Google Cloud Storage (GCS) artifact.Service. |
|
cmd
|
|
|
adkgo
command
adkgo is a CLI tool to help deploy and test an ADK application.
|
adkgo is a CLI tool to help deploy and test an ADK application. |
|
adkgo/internal/deploy
Package deploy allows to run deployment-related subcommands.
|
Package deploy allows to run deployment-related subcommands. |
|
adkgo/internal/deploy/cloudrun
Package cloudrun handles command line parameters and execution logic for cloudrun deployment.
|
Package cloudrun handles command line parameters and execution logic for cloudrun deployment. |
|
adkgo/internal/root
Package root handles command line parameters
|
Package root handles command line parameters |
|
launcher
Package launcher provides ways to interact with agents.
|
Package launcher provides ways to interact with agents. |
|
launcher/console
Package console provides a simple way to interact with an agent from console application.
|
Package console provides a simple way to interact with an agent from console application. |
|
launcher/full
Package full provides easy way to play with ADK with all available options
|
Package full provides easy way to play with ADK with all available options |
|
launcher/prod
Package prod provides easy way to play with ADK with all available options without development support (no console, no ADK Web UI) including only production options like the REST API and A2A support.
|
Package prod provides easy way to play with ADK with all available options without development support (no console, no ADK Web UI) including only production options like the REST API and A2A support. |
|
launcher/universal
Package universal provides an umbrella over launchers (console and web).
|
Package universal provides an umbrella over launchers (console and web). |
|
launcher/web
Package web provides a way to run ADK using a web server.
|
Package web provides a way to run ADK using a web server. |
|
launcher/web/a2a
Package a2a provides a sublauncher that provides A2A capabilities.
|
Package a2a provides a sublauncher that provides A2A capabilities. |
|
launcher/web/api
Package api provides a sublauncher that adds ADK REST API capabilities.
|
Package api provides a sublauncher that adds ADK REST API capabilities. |
|
launcher/web/webui
Package webui provides a sublauncher that adds ADK Web UI capabilities.
|
Package webui provides a sublauncher that adds ADK Web UI capabilities. |
|
examples
|
|
|
a2a
command
Package main provides an example ADK agent that uses A2A.
|
Package main provides an example ADK agent that uses A2A. |
|
mcp
command
Package provides an example ADK agent that uses MCP tools.
|
Package provides an example ADK agent that uses MCP tools. |
|
quickstart
command
Package provides a quickstart ADK agent.
|
Package provides a quickstart ADK agent. |
|
rest
command
Package provides an example ADK REST API server with an ADK agent.
|
Package provides an example ADK REST API server with an ADK agent. |
|
tools/loadartifacts
command
Package provides an example ADK agent that loads and describes artifacts.
|
Package provides an example ADK agent that loads and describes artifacts. |
|
tools/multipletools
command
Package demonstrates a workaround for using Google Search tool with other tools.
|
Package demonstrates a workaround for using Google Search tool with other tools. |
|
vertexai/imagegenerator
command
Package main demonstrates how to create an agent that can generate images using Vertex AI's Imagen model, save them as artifacts, and then save them to the local filesystem.
|
Package main demonstrates how to create an agent that can generate images using Vertex AI's Imagen model, save them as artifacts, and then save them to the local filesystem. |
|
web
command
|
|
|
web/agents
Package agents contains sample agents to demonstate ADK Web Capabilities.
|
Package agents contains sample agents to demonstate ADK Web Capabilities. |
|
workflowagents/loop
command
Package demonstrates a workflow agent that runs a loop agent.
|
Package demonstrates a workflow agent that runs a loop agent. |
|
workflowagents/parallel
command
Package demonstrates a workflow agent that runs sub-agents in parallel.
|
Package demonstrates a workflow agent that runs sub-agents in parallel. |
|
workflowagents/sequential
command
Package demonstrates a workflow agent that runs sub-agents sequentially.
|
Package demonstrates a workflow agent that runs sub-agents sequentially. |
|
workflowagents/sequentialCode
command
Package demonstrates a coding workflow agent that runs sub-agents sequentially.
|
Package demonstrates a coding workflow agent that runs sub-agents sequentially. |
|
internal
|
|
|
cli/util
Package util provides helper functions for execution of commands and presenting their stderr and stdout in uniform way.
|
Package util provides helper functions for execution of commands and presenting their stderr and stdout in uniform way. |
|
httprr
Package httprr implements HTTP record and replay, mainly for use in tests.
|
Package httprr implements HTTP record and replay, mainly for use in tests. |
|
sessioninternal
Package tool defines internal-only interfaces and logic for tools.
|
Package tool defines internal-only interfaces and logic for tools. |
|
telemetry
Package telemetry sets up the open telemetry exporters to the ADK.
|
Package telemetry sets up the open telemetry exporters to the ADK. |
|
toolinternal
Package tool defines internal-only interfaces and logic for tools.
|
Package tool defines internal-only interfaces and logic for tools. |
|
toolinternal/toolutils
Package tool defines internal-only interfaces and logic for tools.
|
Package tool defines internal-only interfaces and logic for tools. |
|
typeutil
Package typeutil is a collection of type handling utility functions.
|
Package typeutil is a collection of type handling utility functions. |
|
Package memory defines the entities to interact with agent memory (long-term knowledge).
|
Package memory defines the entities to interact with agent memory (long-term knowledge). |
|
Package model defines the interfaces and data structures for interacting with LLMs.
|
Package model defines the interfaces and data structures for interacting with LLMs. |
|
gemini
Package gemini implements the model.LLM interface for Gemini models.
|
Package gemini implements the model.LLM interface for Gemini models. |
|
Package runner provides a runtime for ADK agents.
|
Package runner provides a runtime for ADK agents. |
|
Package server hosts protocol implementations to expose and serve ADK agents.
|
Package server hosts protocol implementations to expose and serve ADK agents. |
|
adka2a
Package adka2a allows to expose ADK agents via A2A.
|
Package adka2a allows to expose ADK agents via A2A. |
|
adkrest/controllers
Package controllers contains the controllers for the ADK REST API.
|
Package controllers contains the controllers for the ADK REST API. |
|
adkrest/internal/models
Package models defines the data structures for the REST API.
|
Package models defines the data structures for the REST API. |
|
adkrest/internal/routers
Package routers defines the HTTP routes for the ADK REST API.
|
Package routers defines the HTTP routes for the ADK REST API. |
|
adkrest/internal/services
Package services contains services defined for the ADK-Web REST API.
|
Package services contains services defined for the ADK-Web REST API. |
|
Package session provides types to manage user sessions and their states.
|
Package session provides types to manage user sessions and their states. |
|
Package telemetry allows to set up custom telemetry processors that the ADK events will be emitted to.
|
Package telemetry allows to set up custom telemetry processors that the ADK events will be emitted to. |
|
Package tool defines the interfaces for tools that can be called by an agent.
|
Package tool defines the interfaces for tools that can be called by an agent. |
|
agenttool
Package agenttool provides a tool that allows an agent to call another agent.
|
Package agenttool provides a tool that allows an agent to call another agent. |
|
exitlooptool
Package exitlooptool provides a tool that allows an agent to exit a loop.
|
Package exitlooptool provides a tool that allows an agent to exit a loop. |
|
functiontool
Package functiontool provides a tool that wraps a Go function.
|
Package functiontool provides a tool that wraps a Go function. |
|
geminitool
Package geminitool provides access to Gemini native tools.
|
Package geminitool provides access to Gemini native tools. |
|
loadartifactstool
Package loadartifactstool defines a tool for loading artifacts.
|
Package loadartifactstool defines a tool for loading artifacts. |
|
mcptoolset
Package mcptoolset provides an MCP tool set.
|
Package mcptoolset provides an MCP tool set. |
|
util
|
|
|
instructionutil
Package instructionutil provides utilities to work with agent instructions.
|
Package instructionutil provides utilities to work with agent instructions. |
Click to show internal directories.
Click to hide internal directories.