Practical overview
When it fits
Use ADK when building an AI agent application in TypeScript and you want to define its behavior and orchestration in code, then develop it with the framework’s CLI or web UI.
Who it is for
- TypeScript developers building AI-powered applications for Node.js or browser runtimes.
- Teams implementing agent workflows that need tool use, multi-agent orchestration, or code-managed behavior.
Documented uses
- Define agent behavior, instructions and tool access in TypeScript.
- Compose sequential, parallel, loop or routed agent workflows, including delegation to remote agents through A2A.
- Add built-in search and URL tools, connect MCP servers, or wrap functions as tools.
- Develop and inspect agents using the CLI or interactive web development UI.
Requirements & limits
The repository identifies the project as open source under the Apache-2.0 license. The documented TypeScript prerequisite is Node.js 20.19 or newer.
- The framework supports Node.js and browser runtimes, with ESM, CommonJS and web bundles.
- Built-in tools include Google Search, Google Maps, Vertex AI Search and URL context; MCP connections and function-wrapped tools are also supported.
- The quick start documents authentication through a Google AI Studio API key or Vertex AI credentials.
- The CLI and web UI are installed separately through
@google/adk-devtools. - The README documents a Cloud Run deployment command, while the quick-start steps focus on local development.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Create and locally test a TypeScript search agent
Set up the ADK TypeScript packages, define a Google Search agent, and start it in the CLI or development UI.
Before you start
- Node.js 20.19 or newer
- An agent project directory
- A Google AI Studio API key, or Vertex AI environment settings and Google Cloud application-default authentication
Steps
Install the core SDK and development tools with the command below and the command below.
npm install @google/adknpm install -D @google/adk-devtoolsFor API-key authentication, place
GOOGLE_GENAI_API_KEY=your-api-key-herein a.envfile next to the agent. For Vertex AI, setGOOGLE_GENAI_USE_VERTEXAI=1,GOOGLE_CLOUD_PROJECT, andGOOGLE_CLOUD_LOCATION, then authenticate withgcloud auth application-default login.Create
agent.tswith anLlmAgentnamedsearch_assistant, modelgemini-flash-latest, an instruction to answer questions using Google Search when needed, andtools: [GOOGLE_SEARCH].From the agent project directory, run the command below for the interactive CLI, or the command below for the development UI.
npx @google/adk-devtools run agent.tsnpx @google/adk-devtools web
Expected outcome
The agent can be started locally in the interactive CLI or the ADK development UI for testing and debugging.
Guide limitations
- The documented prerequisite is Node.js 20.19 or newer.
- The web command is described as a development UI for testing and debugging; this recipe does not cover deployment.
- Use the fully qualified
@google/adk-devtoolspackage name: the README warns that barenpx adkmay run an unrelated package.
Compare options for Agent orchestration
These projects document a common task and share a project role. This is a source-based comparison, not an execution benchmark or a guarantee of interchangeability.
| Project | Documented purpose | Platform | Access and requirements |
|---|---|---|---|
| Agent Development Kit (ADK) for TypeScript | Define agent behavior, instructions and tool access in TypeScript. | CLI | The repository identifies the project as open source under the Apache-2.0 license. The documented TypeScript prerequisite is Node.js 20.19 or newer. |
| Agenite | Define typed tools with JSON Schema validation and error handling. | CLI | |
| Veldra | Create an agent with a policy, tools, skills, knowledge base and reasoning method. | Self-hosted | The documented deployment is self-hosted and uses a sign-in gate after a first-run administrator account is created. |
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 12 October 2026
- Original website title
- google/adk-js · Official homepage title · retained in its source language

