Skip to content

Wire demo (local browser UI) ​

Language: 简体中文 | 日本語 | 四川话 | English

Full-stack example: FastAPI serves a chat UI; the browser consumes Agent.arun_wire() as application/x-ndjson.

GitHub Pages cannot host the live demo

The docs site is static only. Run the server locally to try streaming chat.

Preview ​

pagent wire demo — chat UI with reasoning and Wire log

Streaming reply, optional reasoning block, and Wire log drawer (JSON-RPC lines from arun_wire()).

Architecture ​

Components ​

Browser and server ​

Inside FastAPI ​

Agent.arun_wire, tools, session 小帕:

GET / serves index.html. The browser parses each Wire line (method + params) for the UI and drawer.

PieceFileRole
SPAstatic/index.htmlfetch("/api/chat"), read NDJSON lines, render bubbles / tools / reasoning
APIserver.pyStreamingResponse from agent.arun_wire(message)
LibrarypagentAgent loop, events → JSON-RPC Wire (protocol)

Each chat request creates a new Agent (demo simplicity; a real app would reuse session per user).

Request flow ​

Turns, TextDelta / ToolResult, and RunEnd are more events on the same A-->>UI arrow (see events). Stop uses AbortController on fetch — not a Wire method.

Cancel / stop ​

Wire has no cancel method — stopping generation closes the HTTP stream. Tool approval is also out of scope in this demo.

Run ​

Examples use uv run. New to uv? See the official docs.

bash
git clone https://github.com/SyncLionPaw/pagent.git
cd pagent
export DEEPSEEK_API_KEY="your-key"

uv run --with fastapi --with uvicorn python examples/wire_browser/server.py

Open http://127.0.0.1:8765

Stop ​

  • Server: Ctrl+C in the terminal
  • While streaming: click 停止 in the UI (aborts the HTTP request)

What it shows ​

  • Chat UI with tool cards and optional reasoning block
  • Side drawer with raw Wire NDJSON lines
  • Same protocol as Wire protocol — not a separate message system

Source: examples/wire_browser/ on GitHub.

Released under the MIT License.