Skip to content
GkGo

Google ADK (Go)

Google Agent Development Kit for Go — LLM and workflow agents, typed function tools, MCP, A2A and Cloud-native serving.

Google ADK for Go. Build Gemini-powered agents with idiomatic Go: typed function tools, iter.Seq2 event streams, context cancellation, MCP, A2A and ready-made REST and A2A servers.

Install

Terminal window
go get google.golang.org/adk@v1.9.0

Version

v1.9.0 · Go 1.25+ (checked 2026-11-19)

Best for

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

package main
import (
"context"
"fmt"
"log"
"os"
"google.golang.org/genai"
"google.golang.org/adk/agent"
"google.golang.org/adk/agent/llmagent"
"google.golang.org/adk/model/gemini"
"google.golang.org/adk/runner"
"google.golang.org/adk/session"
)
func main() {
ctx := context.Background()
model, err := gemini.NewModel(ctx, "gemini-3.8-flash", &genai.ClientConfig{
APIKey: os.Getenv("GOOGLE_API_KEY"),
})
if err != nil {
log.Fatal(err)
}
assistant, err := llmagent.New(llmagent.Config{
Name: "assistant",
Model: model,
Instruction: "You are a helpful assistant.",
})
if err != nil {
log.Fatal(err)
}
r, err := runner.New(runner.Config{
AppName: "demo",
Agent: assistant,
SessionService: session.InMemoryService(),
AutoCreateSession: true,
})
if err != nil {
log.Fatal(err)
}
msg := genai.NewContentFromText("What is 15 + 27?", genai.RoleUser)
for event, err := range r.Run(ctx, "u1", "s1", msg, agent.RunConfig{}) {
if err != nil {
log.Fatal(err)
}
if event.IsFinalResponse() && event.Content != nil {
fmt.Println(event.Content.Parts[0].Text)
}
}
}

Ready? Start Zero → Hero Step 1 →


DateVersionChanges
2026-10-24currentComprehensive guide gained human approval for tool calls, memory and artifacts, and a scripted-model test that exercises a tool; production guide gained the adkgo deploy CLI. Links made root-absolute.
2026-10-21currentRe-verified against the current module release and rewrote all three Go pages: the earlier examples used an API ADK for Go never had (cloud.google.com/go/adk, gemini.New, agent.Run(ctx, input)). All programs now compile against the release; Go requirement corrected to 1.25; version now read from the site’s version data.
2026-04-211.0.0Index redesigned with Zero → Hero + Jump-to-topic grid.
March 20261.0.0First stable release.
November 20250.1.0Initial Go port.

Other languages: Python · TypeScript.