adk-go-agent-builder

ADK Go Agent Builder

Google's Agent Development Kit has an official, actively maintained Go module: google.golang.org/adk/v2 (go get google.golang.org/adk/v2, requires Go 1.26+). This is a distinct, real SDK — not a hypothetical or Python-only port — with its own idioms that differ from the Python/Java/ Kotlin/TypeScript ADK variants. Ground every code sample in the packages below rather than porting Python ADK syntax (google.adk.agents.Agent, decorator-based tools) directly into Go; the Go API is call-based and config-struct-driven.

Core packages

Minimal agent

package main

import (
	"context"
	"log"
	"os"

	"google.golang.org/genai"

	"google.golang.org/adk/v2/agent"
	"google.golang.org/adk/v2/agent/llmagent"
	"google.golang.org/adk/v2/cmd/launcher"
	"google.golang.org/adk/v2/cmd/launcher/full"
	"google.golang.org/adk/v2/model/gemini"
)

func main() {
	ctx := context.Background()

	model, err := gemini.NewModel(ctx, "gemini-flash-latest", &genai.ClientConfig{
		APIKey: os.Getenv("GOOGLE_API_KEY"),
	})
	if err != nil {
		log.Fatalf("create model: %v", err)
	}

	weatherAgent, err := llmagent.New(llmagent.Config{
		Name:        "weather_agent",
		Model:       model,
		Description: "Answers questions about current weather.",
		Instruction: "Your SOLE purpose is to answer weather questions. Refuse anything else.",
	})
	if err != nil {
		log.Fatalf("create agent: %v", err)
	}

	l := full.NewLauncher()
	cfg := &launcher.Config{AgentLoader: agent.NewSingleLoader(weatherAgent)}
	if err := l.Execute(ctx, cfg, os.Args[1:]); err != nil {
		log.Fatalf("run: %v\n\n%s", err, l.CommandLineSyntax())
	}
}