Install
npm install @google/adk zodnpm install -D @google/adk-devtoolsTypeScript edition of the Google Agent Development Kit — LlmAgent, Zod-typed tools, runners, graph workflows, MCP and A2A for Node.js and the browser.
The TypeScript edition of Google ADK. LlmAgent, Zod-typed function tools, a Runner with session, memory and artifact services, plugins, graph Workflows with human-in-the-loop pauses, MCP and A2A, with ESM, CommonJS and browser builds.
Install
npm install @google/adk zodnpm install -D @google/adk-devtoolsVersion
v2.4.0 (checked 2026-11-19)
Best for
Gemini agents in Node.js backends and full-stack TypeScript apps.
Agents do not run themselves; a Runner drives them. InMemoryRunner wires in in-memory services, and runEphemeral runs one turn without keeping the session.
import {FunctionTool, InMemoryRunner, LlmAgent, isFinalResponse, stringifyContent} from '@google/adk';import {z} from 'zod';
const getWeather = new FunctionTool({ name: 'get_weather', description: 'Returns the current weather for a city.', parameters: z.object({city: z.string().describe('City name')}), execute: async ({city}) => ({city, forecast: 'sunny', tempC: 21}),});
export const rootAgent = new LlmAgent({ name: 'assistant', model: 'gemini-3.8-flash', instruction: 'You are a helpful assistant. Use get_weather for weather questions.', tools: [getWeather],});
const runner = new InMemoryRunner({agent: rootAgent, appName: 'demo'});
for await (const event of runner.runEphemeral({ userId: 'u1', newMessage: {role: 'user', parts: [{text: 'What is the weather in Leeds?'}]},})) { if (isFinalResponse(event)) { console.log(stringifyContent(event)); }}Set GOOGLE_GENAI_API_KEY (GOOGLE_API_KEY and GEMINI_API_KEY also work), or use Vertex AI with GOOGLE_GENAI_USE_ENTERPRISE=1 plus GOOGLE_CLOUD_PROJECT and GOOGLE_CLOUD_LOCATION. The file uses top-level await, so the package needs "type": "module". With rootAgent exported, npx adk run agent.ts chats with it in the terminal and npx adk web opens the dev UI.
The 2.0.0 release (August 2026) introduced graph orchestration and made a few breaking changes:
Workflow, FunctionNode, JoinNode, Edge and START arrive; Workflow is still marked experimental. A bare Workflow can be the root of a Runner or App.BaseAgent now extends BaseNode, so agents inherit rerunOnResume, retryConfig, timeout and the schema fields. A subclass that declares a field of the same name now collides with the inherited one.SequentialAgent, ParallelAgent and LoopAgent log a one-time deprecation warning; they still work.LLMAgentWrapper is removed — pass an agent to an edge directly.InvocationContext.agent is optional; inside an agent, use requireAgent(ctx).FunctionTool gained requireConfirmation for human approval, and Runner.runLive arrived for live sessions.Later 2.x releases added planners (BuiltInPlanner, PlanReActPlanner), ContainerCodeExecutor, Runner.autoCreateSession (opt-in), DebugLoggingPlugin and ToolCallIntegrityPlugin, alongside parity work with the Python kit. Release notes are in the adk-js changelog.
| Date | Version | Changes |
|---|---|---|
| 2026-11-02 | 2.4.0 | Re-verified against the npm release: AgentToolConfig.skipSummarization is still stored but unused, and Workflow is still experimental. |
| 2026-10-24 | current | Added the comprehensive guide and production guide; the tools, sessions, multi-agent and workflow examples moved there. Noted that the npm adk command needs @google/adk-devtools installed. |
| 2026-10-21 | current | Added tools, sessions, multi-agent and workflow examples, each type-checked with tsc --strict and run against a stub model. Dropped the unsupported Node.js version claim. |
| 2026-10-21 | 2.3.0 | Re-verified against the current npm release. Replaced the minimal example, which called a non-existent agent.run(), with a type-checked InMemoryRunner.runEphemeral example; added the 2.x changes; version now read from the site’s version data. |
| 2026-04-21 | 1.0.0 | Bumped to installed v1.0.0 GA after npm introspection; LLMAgent → LlmAgent (matches Python casing). |
| 2026-04-21 | 0.6.1 | Index redesigned with language-selector style. |
| April 4, 2026 | 0.6.1 | Active development release. |