Sandbox
@google/adk-go

Go toolkit for agent building and deployment

ADK Go is a modular framework for building agent applications in Go. It covers agent orchestration, tool use, memory, artifacts, model adapters, and authentication so you can assemble and run agent workflows in one codebase.

8,765 starsโ€ข1k forksโ€ขGoโ€ขUpdated 7d ago
Who it's for

Builders who want to create and ship agent workflows in Go.

What it delivers

You can build agent systems with reusable Go packages instead of wiring everything from scratch.

What it does

Agent orchestration

Defines agent logic and workflow control in `agent/`, including workflow and remote agent support.

Model adapters

Provides model packages under `model/` for Gemini, OpenAI, and other LLM integrations.

Memory and artifacts

Includes `memory/` and `artifact/` packages for persisted context and generated files.

Agent registry and MCP support

Adds `agentregistry/` for discovering and resolving agents, including MCP-related flows.

Auth and platform helpers

Supplies `auth/` and `platform/` utilities for credentials, execution, time, and UUID handling.

CLI and samples

Ships `cmd/adkgo`, `cmd/launcher`, and `examples/` to show how the framework is used.

How to get it

  1. 1To add ADK Go to your project, run
    go get google.golang.org/adk/v2

README

Agent Development Kit (ADK) for Go

License Go Doc Nightly Check r/agentdevelopmentkit View Code Wiki

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 & Kotlin ADK & TypeScript 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/v2

๐Ÿ“– Docs for AI coding agents

adk.dev/llms.txt is a machine-readable index of the ADK documentation, and adk.dev/llms-full.txt is the same documentation as a single file. Both are generated from adk-docs and include the Go API reference and samples, so you can point a coding agent at either one for context:

Plan and implement an agent that reviews customer issues and generates a report. Use the ADK Go framework, referring to https://adk.dev/llms-full.txt for sample code.

To work on this repository rather than build with it, see AGENTS.md.

๐Ÿ“„ 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.

Files in the repo

Repository payloadโ€ข32 top-level entries
  • .agents
  • .github
  • agent
  • agentregistry
  • artifact
  • auth
  • cmd
  • examples
  • internal
  • memory
  • model
  • platform
  • plugin
  • runner
  • scripts
  • server
  • session
  • telemetry
  • tool
  • util
  • workflow
  • .gitignore
  • .golangci.yml
  • AGENTS.md
  • CLAUDE.md
  • CONTRIBUTING.md
  • GEMINI.md
  • go.mod
  • go.sum
  • LICENSE
  • README-v2.md
  • README.md

Discussion (0)

Ask about usage, or say what you built with it

Sign in to join the discussion.

No comments yet. Be the first to say what this is good for.

More frameworks & sdks

HKUDS/nanobotFrameworks & SDKs

Ultra-lightweight, open-source, self-hosted personal AI agent framework in Python with WebUI, tools, memory, MCP, multi-agent workflows, automation, and chat apps

48k
microsoft/
SkillOpt
microsoft/SkillOptFrameworks & SDKs

SkillOpt is a text-space optimizer that trains reusable natural-language skills for frozen LLM agents through trajectory-driven edits, validation-gated updates, and deployable best_skill.md artifacts.

17k
omnigent-ai/omnigentFrameworks & SDKs

Omnigent is an open-source AI agent framework and meta-harness: orchestrate Claude Code, Codex, Cursor, Pi, and custom agents โ€” swap harnesses without rewriting, enforce policies and sandboxing, and collaborate in real time from any device.

9.8k
kyegomez/
OpenMythos
kyegomez/OpenMythosFrameworks & SDKs

A theoretical reconstruction of the Claude Mythos architecture, built from first principles using the available research literature.

15k
D4Vinci/ScraplingFrameworks & SDKs

๐Ÿ•ท๏ธ An adaptive Web Scraping framework that handles everything from a single request to a full-scale crawl!

80k