# adk-js
**Repository Path**: mirrors_google/adk-js
## Basic Information
- **Project Name**: adk-js
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-10-11
- **Last Updated**: 2026-07-04
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Agent Development Kit (ADK) for TypeScript
[](LICENSE)
[](https://www.npmjs.com/package/@google/adk)
[](https://www.reddit.com/r/agentdevelopmentkit/)
An open-source, code-first TypeScript toolkit for building, evaluating,
and deploying sophisticated AI agents with flexibility and control.
---
Agent Development Kit (ADK) is a flexible and modular framework for building,
deploying, and orchestrating AI agent workflows, from simple tasks to complex
multi-agent systems. Define agent behavior, orchestration, and tool use directly
in code, enabling robust debugging, versioning, and deployment anywhere.
The TypeScript version of ADK is built for the Node.js and browser ecosystems,
with full type safety, Zod schema validation, and support for ESM, CommonJS, and
web runtimes.
## ✨ Key Features
- **Code-First TypeScript**: Define agent logic, tools, and orchestration with
full type safety. Tool parameters support Zod v3 and v4 schemas with
compile-time type inference.
- **Browser and Server**: Ships ESM, CommonJS, and web bundles. Run agents in
Node.js or directly in the browser.
- **Rich Tool Ecosystem**: Built-in tools for Google Search, Google Maps, Vertex
AI Search, and URL context. Connect MCP servers, wrap any function as a tool,
or add code execution.
- **Multi-Agent Orchestration**: Compose agents into sequential, parallel, loop,
and routed workflows. Delegate to remote agents via the A2A protocol.
- **Dev Tools and CLI**: Interactive dev UI for testing and debugging. CLI
commands for scaffolding (`adk create`), local testing (`adk run`, `adk web`),
and deployment (`adk deploy cloud_run`).
## 🚀 Installation
```bash
npm install @google/adk
npm install -D @google/adk-devtools
```
Or with yarn:
```bash
yarn add @google/adk
yarn add -D @google/adk-devtools
```
This installs the core SDK and the dev tools (CLI and dev UI) as a dev
dependency.
## Quick Start
Define an agent:
```typescript
import {LlmAgent, GOOGLE_SEARCH} from '@google/adk';
export const rootAgent = new LlmAgent({
name: 'search_assistant',
description: 'An assistant that can search the web.',
model: 'gemini-flash-latest',
instruction:
'You are a helpful assistant. Answer user questions using Google Search when needed.',
tools: [GOOGLE_SEARCH],
});
```
Run from your agent project directory:
```bash
# Interactive CLI
npx adk run agent.ts
# Web UI
npx adk web
```
The `adk web` command launches a development UI for testing and debugging
agents:
## 📚 Documentation
- **Getting Started**: https://adk.dev/get-started/typescript
- **Samples**: https://github.com/google/adk-samples
## 🤝 Contributing
We welcome contributions from the community! Whether it's bug reports, feature
requests, documentation improvements, or code contributions, please see the
[contributing guide](https://adk.dev/community/contributing-guide/) and
[CONTRIBUTING.md](./CONTRIBUTING.md) to get started.
## 📄 License
This project is licensed under the Apache 2.0 License - see the
[LICENSE](LICENSE) file for details.