# google/adk-kotlin architecture

> Architecture diagram of the GitHub repository google/adk-kotlin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-30). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/google/adk-kotlin
- Repository: https://github.com/google/adk-kotlin

## Overview

ADK for Kotlin is a code-first framework for building, running, and extending AI agents. A developer defines an agent with a model and tools; agents can be composed into multi-agent workflows, and runtime state is represented by sessions and events. The repository also provides persistent and cloud-backed services, HTTP serving, device and Firebase model integrations, Java interop, and remote-agent support. The README documents the central agent/model/tool setup and module capabilities; sampled source is concentrated on session and memory storage, so other runtime links are left unverified.

Main entry points: [`core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt`](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt) (Agent runner), [`core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt`](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt) (Agent definition), [`core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt`](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt) (Model interface), [`core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt`](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt) (Session state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_agent_runtime["Agent runtime"]
  node_agent["Agent definition<br/>[LlmAgent.kt]"]
  node_composition["Agent composition<br/>[SequentialAgent.kt]"]
  node_runner["Agent runner<br/>[AbstractRunner.kt]"]
  node_processors["Run processors"]
  node_callbacks["Callbacks and plugins"]
  node_events["Events and content<br/>[Event.kt]"]
end

subgraph group_capabilities["Models and tools"]
  node_model["Model interface<br/>[Model.kt]"]
  node_gemini["Gemini model<br/>[Gemini.kt]"]
  node_tools["Tool ecosystem<br/>[FunctionTool.kt]"]
end

subgraph group_state["State and persistence"]
  node_memory["Memory services<br/>[MemoryService.kt]"]
  node_rag_memory["Vertex RAG memory"]
  node_session_api["Session service API<br/>[SessionService.kt]"]
  node_session["Session state<br/>[Session.kt]"]
  node_memory_store[("In-memory sessions")]
  node_room_store[("Room sessions")]
  node_artifacts["Artifact services<br/>[ArtifactService.kt]"]
end

subgraph group_serving["Serving and integrations"]
  node_webserver["HTTP server<br/>[RunRoutes.kt]"]
  node_a2a["Remote agents<br/>[A2AAgentImpl.kt]"]
  node_analytics["BigQuery analytics"]
end

subgraph group_platforms["Platform adapters"]
  node_spring["Spring AI adapter"]
  node_firebase["Firebase AI model<br/>[Firebase.kt]"]
  node_litert["LiteRT-LM model<br/>[LiteRtLmModel.kt]"]
  node_mlkit["ML Kit prompt model<br/>[GenaiPrompt.kt]"]
  node_java_interop["Java interop<br/>[PublisherRunner.kt]"]
end

node_developer(("Agent developer"))

node_developer -->|"defines"| node_agent
node_developer -->|"configures"| node_gemini
node_developer -->|"adds tools"| node_tools
node_agent -.->|"uses model"| node_model
node_agent -.->|"invokes tools"| node_tools
node_composition -.->|"composes agents"| node_agent
node_runner -.->|"runs"| node_agent
node_runner -.->|"uses sessions"| node_session_api
node_runner -.->|"processes turns"| node_processors
node_runner -.->|"emits events"| node_events
node_processors -.->|"prepares requests"| node_model
node_agent -.->|"supports callbacks"| node_callbacks
node_session_api -->|"loads and updates"| node_session
node_memory_store -->|"stores sessions"| node_session
node_room_store -->|"stores sessions"| node_session
node_memory -->|"implemented by"| node_rag_memory
node_runner -.->|"uses artifacts"| node_artifacts
node_webserver -.->|"serves agent runs"| node_runner
node_a2a -.->|"adapts remote agents"| node_agent
node_analytics -.->|"observes runs"| node_callbacks
node_spring -->|"adapts model"| node_model
node_firebase -->|"provides model"| node_model
node_litert -->|"provides model"| node_model
node_mlkit -->|"provides model"| node_model
node_java_interop -->|"publishes events"| node_runner

click node_agent "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt"
click node_composition "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/agents/SequentialAgent.kt"
click node_runner "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt"
click node_processors "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/processors/LlmRequestProcessor.kt"
click node_callbacks "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/callbacks/CallbacksPipeline.kt"
click node_events "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/events/Event.kt"
click node_model "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt"
click node_gemini "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/models/Gemini.kt"
click node_tools "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/tools/FunctionTool.kt"
click node_memory "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/memory/MemoryService.kt"
click node_rag_memory "https://github.com/google/adk-kotlin/blob/main/core/src/jvmMain/kotlin/com/google/adk/kt/memory/VertexAiRagMemoryService.kt"
click node_session_api "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt"
click node_session "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt"
click node_memory_store "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt"
click node_room_store "https://github.com/google/adk-kotlin/blob/main/core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt"
click node_artifacts "https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/artifacts/ArtifactService.kt"
click node_webserver "https://github.com/google/adk-kotlin/blob/main/webserver/src/jvmMain/kotlin/com/google/adk/kt/webserver/routes/RunRoutes.kt"
click node_a2a "https://github.com/google/adk-kotlin/blob/main/a2a/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/a2a/agent/A2AAgentImpl.kt"
click node_analytics "https://github.com/google/adk-kotlin/blob/main/integrations/src/jvmMain/kotlin/com/google/adk/kt/plugins/agentanalytics/BigQueryAgentAnalyticsPlugin.kt"
click node_spring "https://github.com/google/adk-kotlin/blob/main/integrations/spring/src/jvmMain/kotlin/com/google/adk/kt/models/springai/SpringAiMessages.kt"
click node_firebase "https://github.com/google/adk-kotlin/blob/main/firebase/src/main/kotlin/com/google/adk/firebase/models/Firebase.kt"
click node_litert "https://github.com/google/adk-kotlin/blob/main/litertlm/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/litertlm/LiteRtLmModel.kt"
click node_mlkit "https://github.com/google/adk-kotlin/blob/main/mlkit/src/main/kotlin/com/google/adk/kt/mlkit/GenaiPrompt.kt"
click node_java_interop "https://github.com/google/adk-kotlin/blob/main/core/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/interop/PublisherRunner.kt"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_agent,node_composition,node_runner,node_processors,node_callbacks,node_events toneBlue
class node_model,node_gemini,node_tools toneAmber
class node_memory,node_rag_memory,node_session_api,node_session,node_memory_store,node_room_store,node_artifacts toneMint
class node_webserver,node_a2a,node_analytics toneRose
class node_spring,node_firebase,node_litert,node_mlkit,node_java_interop,node_developer toneIndigo
```

## Components

### Agent runtime

- [Agent definition](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt): `core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt`
- [Agent composition](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/agents/SequentialAgent.kt): `core/src/commonMain/kotlin/com/google/adk/kt/agents/SequentialAgent.kt`
- [Agent runner](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt): `core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt`
- [Run processors](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/processors/LlmRequestProcessor.kt): `core/src/commonMain/kotlin/com/google/adk/kt/processors/LlmRequestProcessor.kt`
- [Callbacks and plugins](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/callbacks/CallbacksPipeline.kt): `core/src/commonMain/kotlin/com/google/adk/kt/callbacks/CallbacksPipeline.kt`
- [Events and content](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/events/Event.kt): `core/src/commonMain/kotlin/com/google/adk/kt/events/Event.kt`

### Models and tools

- [Model interface](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt): `core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt`
- [Gemini model](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/models/Gemini.kt): `core/src/commonMain/kotlin/com/google/adk/kt/models/Gemini.kt`
- [Tool ecosystem](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/tools/FunctionTool.kt): `core/src/commonMain/kotlin/com/google/adk/kt/tools/FunctionTool.kt`

### State and persistence

- [Memory services](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/memory/MemoryService.kt): `core/src/commonMain/kotlin/com/google/adk/kt/memory/MemoryService.kt`
- [Vertex RAG memory](https://github.com/google/adk-kotlin/blob/main/core/src/jvmMain/kotlin/com/google/adk/kt/memory/VertexAiRagMemoryService.kt): `core/src/jvmMain/kotlin/com/google/adk/kt/memory/VertexAiRagMemoryService.kt`
- [Session service API](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt): `core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt`
- [Session state](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt): `core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt`
- [In-memory sessions](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt): `core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt`
- [Room sessions](https://github.com/google/adk-kotlin/blob/main/core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt): `core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt`
- [Artifact services](https://github.com/google/adk-kotlin/blob/main/core/src/commonMain/kotlin/com/google/adk/kt/artifacts/ArtifactService.kt): `core/src/commonMain/kotlin/com/google/adk/kt/artifacts/ArtifactService.kt`

### Serving and integrations

- [HTTP server](https://github.com/google/adk-kotlin/blob/main/webserver/src/jvmMain/kotlin/com/google/adk/kt/webserver/routes/RunRoutes.kt): `webserver/src/jvmMain/kotlin/com/google/adk/kt/webserver/routes/RunRoutes.kt`
- [Remote agents](https://github.com/google/adk-kotlin/blob/main/a2a/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/a2a/agent/A2AAgentImpl.kt): `a2a/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/a2a/agent/A2AAgentImpl.kt`
- [BigQuery analytics](https://github.com/google/adk-kotlin/blob/main/integrations/src/jvmMain/kotlin/com/google/adk/kt/plugins/agentanalytics/BigQueryAgentAnalyticsPlugin.kt): `integrations/src/jvmMain/kotlin/com/google/adk/kt/plugins/agentanalytics/BigQueryAgentAnalyticsPlugin.kt`

### Platform adapters

- [Spring AI adapter](https://github.com/google/adk-kotlin/blob/main/integrations/spring/src/jvmMain/kotlin/com/google/adk/kt/models/springai/SpringAiMessages.kt): `integrations/spring/src/jvmMain/kotlin/com/google/adk/kt/models/springai/SpringAiMessages.kt`
- [Firebase AI model](https://github.com/google/adk-kotlin/blob/main/firebase/src/main/kotlin/com/google/adk/firebase/models/Firebase.kt): `firebase/src/main/kotlin/com/google/adk/firebase/models/Firebase.kt`
- [LiteRT-LM model](https://github.com/google/adk-kotlin/blob/main/litertlm/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/litertlm/LiteRtLmModel.kt): `litertlm/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/litertlm/LiteRtLmModel.kt`
- [ML Kit prompt model](https://github.com/google/adk-kotlin/blob/main/mlkit/src/main/kotlin/com/google/adk/kt/mlkit/GenaiPrompt.kt): `mlkit/src/main/kotlin/com/google/adk/kt/mlkit/GenaiPrompt.kt`
- [Java interop](https://github.com/google/adk-kotlin/blob/main/core/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/interop/PublisherRunner.kt): `core/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/interop/PublisherRunner.kt`

### Other components

- **Agent developer**

## Connections

- Agent developer → Agent definition: defines (evidence: `README.md`)
- Agent developer → Gemini model: configures (evidence: `README.md`)
- Agent developer → Tool ecosystem: adds tools (evidence: `README.md`)
- Agent definition → Model interface: uses model
- Agent definition → Tool ecosystem: invokes tools
- Agent composition → Agent definition: composes agents
- Agent runner → Agent definition: runs
- Agent runner → Session service API: uses sessions
- Agent runner → Run processors: processes turns
- Agent runner → Events and content: emits events
- Run processors → Model interface: prepares requests
- Agent definition → Callbacks and plugins: supports callbacks
- Session service API → Session state: loads and updates (evidence: `core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt`)
- In-memory sessions → Session state: stores sessions (evidence: `core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt`)
- Room sessions → Session state: stores sessions (evidence: `core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt`)
- Memory services → Vertex RAG memory: implemented by (evidence: `core/src/jvmMain/kotlin/com/google/adk/kt/memory/VertexAiRagMemoryService.kt`)
- Agent runner → Artifact services: uses artifacts
- HTTP server → Agent runner: serves agent runs
- Remote agents → Agent definition: adapts remote agents
- BigQuery analytics → Callbacks and plugins: observes runs
- Spring AI adapter → Model interface: adapts model (evidence: `README.md`)
- Firebase AI model → Model interface: provides model (evidence: `README.md`)
- LiteRT-LM model → Model interface: provides model (evidence: `README.md`)
- ML Kit prompt model → Model interface: provides model (evidence: `README.md`)
- Java interop → Agent runner: publishes events (evidence: `README.md`)
