# adk-web
**Repository Path**: mirrors_google/adk-web
## Basic Information
- **Project Name**: adk-web
- **Description**: Agent Development Kit Web (adk web) is the built-in developer UI that is integrated with Agent Development Kit for easier agent development and debugging.
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No
## Statistics
- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-21
- **Last Updated**: 2026-09-26
## Categories & Tags
**Categories**: Uncategorized
**Tags**: None
## README
# Agent Development Kit Web UI (ADK WEB)
[](LICENSE)
[](https://www.reddit.com/r/agentdevelopmentkit/)
Agent Development Kit Web is the built-in developer UI that integrated with Google Agent Development Kit for easier agent development and debug.
Agent Development Kit (ADK) is a flexible and modular framework for developing and deploying AI agents. While optimized for Gemini and the Google ecosystem, ADK is model-agnostic, deployment-agnostic, and is built for compatibility with other frameworks. ADK was designed to make agent development feel more like software development, to make it easier for developers to create, deploy, and orchestrate agentic architectures that range from simple tasks to complex workflows.
ADK web is the built-in dev UI that comes along with adk for easier development and debug.
## ✨ Prerequisites
- **Install [npm](https://docs.npmjs.com/downloading-and-installing-node-js-and-npm)**
- **Install [Node.js](https://nodejs.org/en)**
- **Install [Angular CLI](https://angular.dev/tools/cli)**
- **Install [google-adk (Python)](https://github.com/google/adk-python)**
- **Install [google-adk (Java)](https://github.com/google/adk-java/)**
- **Clone [adk-web (this repo)](https://github.com/google/adk-web/)**
## 🚀 Running adk web
To be able to run `adk web`, follow the steps from the root of your local
adk-web folder:
### Install dependencies
```bash
npm install
```
### Run adk web
```bash
npm run serve
```
### Run adk api web server
In another terminal run:
```bash
adk web
```
The dev server proxies API calls through to the backend, so from the browser's
point of view everything is same-origin. `--allow_origins` and
`--host=0.0.0.0` are no longer needed.
#### Custom frontend and backend ports
Each side picks its own port. Tell the dev server where the backend is with
`ADK_BACKEND`, and pass `--port` through to `ng serve` for the frontend:
```bash
adk web --port 9000 # backend
ADK_BACKEND=http://127.0.0.1:9000 npm run serve -- --port 5555 # frontend
```
The backend never needs to know the frontend's port. `ADK_BACKEND` accepts any
URL, including a remote host (`ADK_BACKEND=http://my-workstation:8000`); a
backend reachable from another machine still needs `--host 0.0.0.0`. Restart
`npm run serve` after changing `ADK_BACKEND`, since the proxy configuration is
read once at startup.
Do not pass `--url_prefix` in this two-process setup — the prefix would not
match the dev server's proxy routes. Reverse-proxy prefixes are exercised by
the backend's own tests instead.
If you see `adk command not found`, then be sure to install `google-adk` (or remember to activate your virtual environment if you are using one)
### Happy development
Go to `localhost:4200` and start developing!
## Screenshots
### Events
### Tracing
### Artifacts
### Evaluations
### Agent builder & assistant
### And more!
## 🤝 Contributing
We welcome contributions from the community! Whether it's bug reports, feature requests, documentation improvements, or code contributions, please see our
- [General contribution guideline and flow](https://google.github.io/adk-docs/contributing-guide/#questions).
### Testing quirks
To maintain compatibility with upstream 1p code, testing code in this repo must
follow a few rules:
- `initTestBed()` from `./src/app/testing/utils.ts` must be called before `TestBed.configureTestingModule()`
## 📄 License
This project is licensed under the Apache 2.0 License - see the [LICENSE](LICENSE) file for details.
## Preview
This feature is subject to the "Pre-GA Offerings Terms" in the General Service Terms section of the [Service Specific Terms](https://cloud.google.com/terms/service-terms#1). Pre-GA features are available "as is" and might have limited support. For more information, see the [launch stage descriptions](https://cloud.google.com/products?hl=en#product-launch-stages).
---
*Happy Agent Building!*