How google/adk-kotlin works
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: AbstractRunner.kt Agent runner · LlmAgent.kt Agent definition · Model.kt Model interface · Session.kt Session state
Components 25
Agent runtime
- Agent definition
core/src/commonMain/kotlin/com/google/adk/kt/agents/LlmAgent.kt - Agent composition
core/src/commonMain/kotlin/com/google/adk/kt/agents/SequentialAgent.kt - Agent runner
core/src/commonMain/kotlin/com/google/adk/kt/runners/AbstractRunner.kt - Run processors
core/src/commonMain/kotlin/com/google/adk/kt/processors/LlmRequestProcessor.kt - Callbacks and plugins
core/src/commonMain/kotlin/com/google/adk/kt/callbacks/CallbacksPipeline.kt - Events and content
core/src/commonMain/kotlin/com/google/adk/kt/events/Event.kt
Models and tools
- Model interface
core/src/commonMain/kotlin/com/google/adk/kt/models/Model.kt - Gemini model
core/src/commonMain/kotlin/com/google/adk/kt/models/Gemini.kt - Tool ecosystem
core/src/commonMain/kotlin/com/google/adk/kt/tools/FunctionTool.kt
State and persistence
- Memory services
core/src/commonMain/kotlin/com/google/adk/kt/memory/MemoryService.kt - Vertex RAG memory
core/src/jvmMain/kotlin/com/google/adk/kt/memory/VertexAiRagMemoryService.kt - Session service API
core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt - Session state
core/src/commonMain/kotlin/com/google/adk/kt/sessions/Session.kt - In-memory sessions
core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt - Room sessions
core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt - Artifact services
core/src/commonMain/kotlin/com/google/adk/kt/artifacts/ArtifactService.kt
Serving and integrations
- HTTP server
webserver/src/jvmMain/kotlin/com/google/adk/kt/webserver/routes/RunRoutes.kt - Remote agents
a2a/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/a2a/agent/A2AAgentImpl.kt - BigQuery analytics
integrations/src/jvmMain/kotlin/com/google/adk/kt/plugins/agentanalytics/BigQueryAgentAnalyticsPlugin.kt
Platform adapters
- Spring AI adapter
integrations/spring/src/jvmMain/kotlin/com/google/adk/kt/models/springai/SpringAiMessages.kt - Firebase AI model
firebase/src/main/kotlin/com/google/adk/firebase/models/Firebase.kt - LiteRT-LM model
litertlm/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/litertlm/LiteRtLmModel.kt - ML Kit prompt model
mlkit/src/main/kotlin/com/google/adk/kt/mlkit/GenaiPrompt.kt - Java interop
core/src/commonJvmAndroidMain/kotlin/com/google/adk/kt/interop/PublisherRunner.kt
Other components
- Agent developer
Connections 25
- Agent developer → Agent definition: defines
README.md - Agent developer → Gemini model: configures
README.md - Agent developer → Tool ecosystem: adds tools
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
core/src/commonMain/kotlin/com/google/adk/kt/sessions/SessionService.kt - In-memory sessions → Session state: stores sessions
core/src/commonMain/kotlin/com/google/adk/kt/sessions/InMemorySessionService.kt - Room sessions → Session state: stores sessions
core/src/androidMain/kotlin/com/google/adk/kt/sessions/room/RoomSessionService.kt - Memory services → Vertex RAG memory: implemented by
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
README.md - Firebase AI model → Model interface: provides model
README.md - LiteRT-LM model → Model interface: provides model
README.md - ML Kit prompt model → Model interface: provides model
README.md - Java interop → Agent runner: publishes events
README.md