Google ADK (Go)

Google ADK for Go — v1.0 GA. Build Gemini-powered agents with idiomatic Go concurrency, type-safe interfaces, MCP, A2A, and native GCP integration.

Install

go get cloud.google.com/go/adk

Version

v1.0.0 GA · April 2026 · Go 1.21+

Best for

Low-latency agent services, idiomatic Go backends, GCP-native deployment.

Zero → Hero

1 · Installation & setup Install, auth, first agent · 15 min

2 · Core architecture Package layout, interfaces · 20 min

3 · Package overview Imports, dependencies · 15 min

4 · Types & interfaces Core types, generics · 25 min

5 · LLMAgent First agent, chat, streaming · 25 min

6 · Agent orchestration Multi-agent patterns · 30 min

7 · Tools system Function tools, built-in tools · 25 min

8 · MCP MCP client + server · 20 min

9 · A2A protocol Cross-framework interop · 20 min

10 · Go idioms & patterns goroutines, channels, contexts · 25 min

11 · Session management Persistence, threads · 15 min

12 · Testing Mocking, integration tests · 20 min

13 · Production Deployment, scaling · 30 min

Jump to a topic

LLMAgent

Agent orchestration

Tools system

MCP

A2A protocol

Go idioms

Session management

Testing

Best practices

v1.0 GA changes

Reference

Comprehensive guide Single-page technical reference.

Recipes

Production guide

What’s new in v1.0.0 GA (April 2026)

• GA release with stable APIs.
• A2A protocol client and server.
• MCP full support.
• Goroutine-first orchestration — agents cooperate via channels.

Install, minimal example

package main

import (
    "context"
    "fmt"

    "cloud.google.com/go/adk"
)

func main() {
    agent := adk.NewLLMAgent(adk.LLMAgentConfig{
        Name:        "assistant",
        Model:       "gemini-2.0-flash-exp",
        Instruction: "You are a helpful assistant.",
    })

    resp, err := agent.Run(context.Background(), "What is 15 + 27?")
    if err != nil {
        panic(err)
    }
    fmt.Println(resp.Text)
}

Ready? Start Zero → Hero Step 1 →

---

Revision history

Date	Version	Changes
2026-04-21	1.0.0	Index redesigned with Zero → Hero + Jump-to-topic grid.
April 8, 2026	1.0.0 GA	Stable APIs; A2A; MCP; goroutine orchestration.
November 2025	0.1.0	Initial Go port.

Other languages: Python · TypeScript.