mrkeyoor.com_
Fri 02 Oct 14:58 UTC
LLM Toolsevaluationupdated 02 Oct 2026

ag-ui review

AG-UI is an event protocol for connecting an AI agent to the interface a person is using. It standardizes streamed messages, shared state, tool calls, and approvals so a frontend does not need a custom event format for every agent framework.

Verdict

Our AG-UI run installed 2,336 packages, then both the build and test wrappers exited 130 within 13 seconds, so the protocol deserves a focused package trial before any team adopts the whole monorepo. Use it when several agent backends must speak one frontend event language. Choose a smaller UI toolkit when one TypeScript application and one agent stack are all you need.

We ran it

Lab card: what happened when we ran ag-uiScreenshot of ag-ui (ag-ui.com)
Install✓ · 100s2336 packages · 2035 MB
Build✗ · 12s
Tests✗ · 13s8 passed · 0 failed of 8 (node:test)
Repo4394 files~851,223 lines of source · 67.4 MB · 29 CI workflows · tests dir

Answers from our run

Does ag-ui build from source?

Dependencies installed in 100 seconds (2336 packages), and the build failed. We cloned commit d1804fb into a clean Debian container with 3 CPUs and no project-specific setup.

Do ag-ui's tests pass?

Yes: 8 of 8 passed when we ran the project's own test command (node:test). Some failures need services or credentials a bare container does not have.

Who should not use ag-ui?

Apps that only need to connect an agent to tools or data: the README assigns that job to MCP, while AG-UI covers the agent-to-user interface connection.

What are the alternatives to ag-ui?

Vercel AI SDK, CopilotKit, Model Context Protocol. Our AG-UI run installed 2,336 packages, then both the build and test wrappers exited 130 within 13 seconds, so the protocol deserves a focused package trial before any team adopts the whole monorepo.

Setup2/52,336 packages and both top-level verification commands exited 130
Docs4/5Protocol roles, integrations, SDKs, and contribution steps are explicit
Community5/516,218 stars, 29 workflows, and an October 2 push
Maturity3/5Core is 1.0.1, while adapters and the 1.1 draft keep moving

Discussed on

  1. hnShow HN: AG-UI Protocol – Bring Agents into Frontend Applications36 points
  2. hnMicrosoft Embraces AG-UI Protocol for Agent UI7 points
  3. hnShow HN: Simulation-Based Testing for Agents Using AG-UI Protocol6 points

Who it’s for

Product teams connecting one frontend to agents built with several frameworks.
Framework authors who need a documented event contract for chat, state, tools, and human approval.
Developers willing to test the exact SDK and middleware pair used in production.
Organizations that want an MIT-licensed protocol with TypeScript, Python, and community language SDKs.

Who it’s NOT for

Apps that only need to connect an agent to tools or data: the README assigns that job to MCP, while AG-UI covers the agent-to-user interface connection.
Teams expecting a small JavaScript library checkout: our monorepo install pulled 2,336 packages and occupied 2,035 MB.
Release gates that require a clean whole-repository command: our build and test wrappers both exited 130, even though the test tail showed 8 passing Node subtests.
Companies that need one core team to maintain every language binding: the contributing guide says community SDK authors maintain their own SDKs.
Google ADK users relying on parallel same-name client tools without regression testing: issue 2856 reports the second call being dropped under Gemini SSE streaming.

Setup reality

Our sandbox installed commit d1804fb in 100 seconds, adding 2,336 packages and using 2,035 MB. The build failed with exit 130 after 12 seconds; the tail named create-ag-ui-app, @ag-ui/core, and @ag-ui/a2ui-toolkit as failed tasks. Tests exited 130 after 13 seconds, although the shown Node test summary had 8 passed and 0 failed.

Trying the protocol means choosing an agent integration, a client, and the model credentials that integration requires. The repository supplies a reference HTTP implementation and a scaffold command, but deployments still need the selected framework's environment, transport, and service configuration. Our no-secrets run did not exercise a live model.

The workspace pins Node 22 and pnpm 10.33.4. It spans TypeScript SDKs, integrations, middleware, apps, a protocol spec, and community SDKs. The 67.4 MB checkout has 29 CI workflow files and a tests directory, but no Dockerfile at the repository root.

About 16 event types replace per-framework UI adapters

AG-UI defines the traffic between an agent backend and a user-facing application. The README describes about 16 standard event types for streamed chat, shared state, frontend tools, structured messages, and human approval. A backend can use SSE, WebSockets, webhooks, or another transport as long as its messages match the protocol. There is also a reference HTTP implementation and a default connector.

AG-UI does not supply the agent or the model. It gives LangGraph, CrewAI, Google ADK, Mastra, Pydantic AI, and other supported backends a common way to talk to an interface. The value appears when one frontend must survive a backend change, or when several agent runtimes need the same rendering and tool behavior.

The repository is much larger than the core package

The TypeScript core package was version 1.0.1 when we checked it, with Zod as a peer dependency. Around it sits an Nx and pnpm workspace with SDKs, middleware, the Dojo app, a specification, and community bindings for Go, Java, Kotlin, Rust, Ruby, C++, Dart, and .NET. A user of one published package does not operate every part. A contributor sees all of it.

The checkout had 4,394 files, roughly 851,223 lines of source, and occupied 67.4 MB before dependencies. Installation expanded it to 2,035 MB. Node 22 is pinned in .node-version, while package.json pins pnpm 10.33.4 and lists Node 18 as the repository install floor. The guide explains that the root range is not a consumer policy for every package.

What happened when we ran it

Our sandbox installed commit d1804fb in 100 seconds. pnpm added 2,336 packages inside a fresh unprivileged Debian container with 3 CPUs, 8 GB of RAM, Node 22, and no secrets. Installation succeeded. The root build exited 130 after 12 seconds, and its tail listed create-ag-ui-app, @ag-ui/core, and @ag-ui/a2ui-toolkit as failed tasks.

The test command also exited 130 after 13 seconds. Its visible Node summary reported 8 passed and 0 failed. Those checks covered package archives, SPDX metadata, license files, notices, package identity, Apache packages, and proprietary packages. pnpm still marked the command failed. The excerpt does not identify which workspace task caused exit 130, so claiming a failed assertion would go beyond the log.

We did not start an agent, connect a frontend, or send a live model request. The result establishes that the top-level commands did not provide a clean verification path at d1804fb in our container. Build the exact SDK and adapter you plan to ship, then run its conformance and interaction tests.

Integration bugs can strand an agent turn

Open issue 2856 describes Google ADK middleware dropping the second of two same-name client tool calls under Gemini SSE streaming. The report says the missing call leaves an unanswered function call, causing later turns to be rejected. It includes a deterministic reproduction and names ag-ui-adk 0.7.0. This is evidence about one adapter path, not every AG-UI integration.

Issue 2924 covers a different edge in the Claude Agent SDK Python adapter. A display-only frontend tool can pass an empty result onward as a blank prompt. The report traces the source path and says no live provider rejection was reproduced. Both reports explain why a protocol badge cannot replace scenario tests for parallel tools, approval, cancellation, and empty results.

Community SDKs come with community ownership

The contributing guide says community integrations and SDKs are maintained by the people who contributed them. A Go or Ruby binding should be judged on its own code owners, releases, conformance coverage, and issue response. The main repository gives these projects a shared home, not identical staffing.

Adding an integration is substantial work. The guide requires a language implementation, TypeScript client, Dojo registration, port wiring, run scripts, end-to-end tests for every advertised feature, and CI configuration. External pull requests do not run those tests by default. Maintainers open an internal PR to trigger CI, so contributors need coordination before a large change.

MCP and A2A solve different connections

The README places AG-UI beside two protocols. MCP connects an agent to tools. A2A connects agents to other agents. AG-UI connects an agent to a person through an application. A product can use all three because each joins a different pair of systems. MCP is the better pick only when tools and resources are the missing connection.

Vercel's AI SDK is simpler for a TypeScript-only product, while CopilotKit supplies application components built around AG-UI. The protocol earns its complexity when backend portability matters. Our 2,336-package install and two exit-130 commands argue against adopting the entire repository by default. Start with one SDK, one adapter, and the interaction cases users cannot afford to lose.

October 2 activity shows fast development, not settled adapters

GitHub showed 16,218 stars, 455 open issues and pull requests, and a last push on October 2, 2026. The October 1 release published @ag-ui/adk-js 0.0.1, while the TypeScript core was 1.0.1. The repository also contains a 1.1 draft. Different parts are moving at different speeds.

That pace helps when your chosen framework has active maintainers. It also calls for pinned versions and adapter-specific release checks. AG-UI is a credible common language for agent interfaces, but approval should come only after the selected client, backend adapter, and failure cases pass together.

Alternatives

ProjectWhat it isPick it when
Vercel AI SDK gh↗A TypeScript toolkit for building AI applications and agent interfaces.pick this instead when your product is already TypeScript-first and a cross-framework wire protocol is unnecessary.
CopilotKit gh↗A frontend framework for shipping agent chat and generative UI using AG-UI.pick this instead when you want ready-made application components rather than the protocol layer itself.
Model Context ProtocolA protocol for connecting models and agents to tools, resources, and prompts.pick this instead when the missing connection is between the agent and its tools, not between the agent and the user interface.

What people are saying

  1. [github-trending] ag-ui-protocol/ag-ui

Sources

  1. AG-UI README
  2. AG-UI contributing guide
  3. AG-UI release 2026-10-01
  4. AG-UI issue 2856
  5. AG-UI issue 2924

More llm tools reviews

whatsapp-mcp · deepseek-recipe · Edge0 · awesome-codex-plugins · claude-style-patch · agent-toolkit-for-aws · the whole board →