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 at http://localhost:4200.
  • Backend – The ADK runtime itself, which you run with the adk web command (installed from the google-adk Python 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

  1. Install Node, npm, and the Angular CLI.
  2. Install the ADK Python or Java SDK (google-adk).
  3. Clone this repo, run npm install, then npm run serve.
  4. In another terminal start the backend with adk web.
  5. Open http://localhost:4200 and 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