ggui-ai/ggui

GGUI は、AI エージェントと人ユーザー間のランタイムネゴティエートのデータ契約の統合UI用のオープンプロトコルです。

ドキュメント・ リリース

公開プレビュー — 前の 1.0.** 全 32 [[@ggui-ai/*]]] パッケージは、ロックステップのマイナーな波で出荷されます。以下のバッジは、現在のものを示します。 プロトコルはドラフトであり、波間の変更もできます。 ピンの正確なバージョン(下のバッジを参照)と各波のノートのリリースを見てください。 [[v1.0]は、プロトコルフリーズをマークします。

お問い合わせ

エージェントは、自然言語で必要なものを記述します。GGUI は、MCP 上でのエピメラル、インタラクティブなインターフェイスを生成します。 フロントエンドコードなし、React テンプレートなし、カスタムコンポーネントなし、エージェントトーク、ユーザーは UI を参照してください。

このリポジトリは、open プロトコル + リファレンスランタイムです。 [ggui serve;任意のMCP-awareエージェントのランタイム(Claude Desktop、Claude Code、claude.ai、Cursor、ChatGPTデスクトップ、Goose、あなた自身の)とペア。 必要なゼロアカウント、必要なゼロ管理されたインフラ、ゼロクラウド依存性。

お問い合わせ

クイックスタート — パスを選ぶ

##1. 黄金のパスを構成 — プラットフォーム構成 (guuey-sdk)

[guuey.jsonからレンダリングされたインタラクティブなTodo UIへの1つのフロー — 公開されたすべての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