ggui-ai/ggui

GGUI - это открытый протокол для генеративного пользовательского интерфейса - контракт на обработку данных между агентами ИИ и пользователями.

Докс · выпуски

. Общественный предварительный просмотр — pre-1.0. Все 32 пакета @ggui-ai/* поставляются с небольшими волнами — значки ниже показывают текущий; протокол является черновым и все еще может меняться между волнами. Точные версии Pin (см. значки ниже) и смотреть выпуски для каждой волны ноты; v1.0 отмечает замораживание протокола.

Агенты описывают, что им нужно в естественном языке; GGUI генерирует эфемерные интерактивные интерфейсы по MCP. Ни интерфейсного кода, ни шаблонов React, ни пользовательских компонентов — агенты разговаривают, пользователи видят пользовательский интерфейс.

Это РЕПО open protocol + reference runtime. Self-host с ggui serve; пара против любого MCP-агента время выполнения (Claude Desktop, Claude Code, claude.ai, Cursor, ChatGPT desktop, Goose, ваш собственный). Нулевая учетная запись, нулевая управляемая инфраструктура, нулевая зависимость от облака.

Быстрый старт - выберите свой путь

###1.Сложенный золотой путь — платформенный (guuey-sdk)

Один поток из guuey.json в визуализированный, интерактивный пользовательский интерфейс — каждая часть опубликованного SDK.

GGUI is an open protocol for generative UI — a runtime-negotiated data contract between AI agents and human users.

Docs · Releases

🚧 Public preview — pre-1.0. All 32 @ggui-ai/* packages ship in lockstep minor waves — the badges below show the current one; the protocol is a draft and may still change between waves. Pin exact versions (see badges below) and watch Releases for each wave’s notes; v1.0 marks the protocol freeze.

---

Agents describe what they need in natural language; GGUI generates ephemeral, interactive interfaces over MCP. No frontend code, no React templates, no custom components — agents talk, users see UI.

This repo is the open protocol + reference runtime. Self-host with ggui serve; pair against any MCP-aware agent runtime (Claude Desktop, Claude Code, claude.ai, Cursor, ChatGPT desktop, Goose, your own). Zero account required, zero managed infrastructure required, zero cloud dependency.

---

Quick start — pick your path

1. Composed golden path — platform-composed (guuey-sdk)

One flow from a guuey.json to a rendered, interactive todo UI — every piece a published SDK. guuey’s dev tooling runs the agent (@guuey/cli + @guuey/worker), the GGUI runtime is the dev router’s injected MCP default, and the web client talks to the router with @guuey/agent-client. This path is platform-composed: it drives the GGUI protocol through guuey’s published SDKs. The protocol itself has no guuey dependency — paths 2–4 run without it, and the framework-native samples (path 2) stay first-class.

Prerequisites: Node.js 22+, pnpm, and an ANTHROPIC_API_KEY (one key drives both the agent and GGUI’s UI generation).

git clone https://github.com/ggui-ai/ggui && cd ggui
pnpm install                        # workspace deps — `guuey dev` spawns the colocated
                                    # todo MCP from samples/mcp-servers/todo
export ANTHROPIC_API_KEY=sk-ant-…   # in every terminal below

# terminal 1 — the ggui runtime MCP (guuey's dev router injects ggui → this port).
# --dev-allow-all admits the bearer-less local callers (the router's ggui
# connection and the web page's relay). Local dev only.
npx -y @ggui-ai/cli serve --mcp-only --dev-allow-all   # http://127.0.0.1:6781/mcp

# terminal 2 — the agent half: guuey.json + a Claude agent worker
cd samples/agents/with-guuey
npm install
npm run dev                              # guuey dev --serve → http://localhost:6790

# terminal 3 — the web half: chat + rendered ggui cards