google/adk-web
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.
Agent Development Kit Web UI (ADK WEB)
What it is – A browser‑based developer console that ships with Google’s Agent Development Kit (ADK). ADK is a modular framework for building, deploying, and orchestrating AI agents (think chat‑bots, autonomous assistants, or workflow‑orchestrating agents). The Web UI gives you a visual front‑end for creating agents, inspecting events, tracing execution, viewing artifacts and evaluation results, and debugging the underlying ADK runtime.
Key pieces
- Frontend – An Angular single‑page app (served with
npm run serve). It talks to the ADK backend via a proxy, so the UI can be run locally athttp://localhost:4200. - Backend – The ADK runtime itself, which you run with the
adk webcommand (installed from thegoogle-adkPython or Java packages). The UI forwards API calls to this process. - Integration – Works out‑of‑the‑box with the Gemini model stack but is model‑agnostic; you can point it at any ADK‑compatible agent implementation.
How to get started
- Install Node, npm, and the Angular CLI.
- Install the ADK Python or Java SDK (
google-adk). - Clone this repo, run
npm install, thennpm run serve. - In another terminal start the backend with
adk web. - Open
http://localhost:4200and you’ll see the UI with tabs for Events, Tracing, Artifacts, Evaluations, and an Agent Builder.
What you can do in the UI
- Events – Browse a timeline of agent‑generated events.
- Tracing – Visualise call‑graphs and execution flow of an agent run.
- Artifacts – Inspect files, logs, or other outputs produced by the agent.
- Evaluations – View metrics and test results for your agent.
- Agent Builder & Assistant – Drag‑and‑drop style interface for assembling agent components and interacting with a live assistant.
Who it’s for – Developers building AI agents who want a richer debugging experience than raw logs. Because it’s part of the ADK ecosystem, it fits naturally into Google‑centric workflows but can be used with any ADK‑compatible model.
Contribution – Follow Google’s ADK contribution guide; tests need a special initTestBed call for Google’s internal CI.
License – Apache 2.0.
Happy Agent Building!
Related
- Project
- Project
- Project
- Project
- Project