Skip to main content

Overview

ProductRole
Xiaohe Agentxiaohe CLI + Session API + embedded Web UI
Xiaohe ClientDesktop app (same chat UI)

Client and Web UI connect to Session over HTTP. Terminal xiaohe can chat without a UI.

Start here​

Pick one path. Installers: Download.

A. Terminal only​

  1. Install Agent
  2. xiaohe — see Agent CLI

B. Browser on this machine​

  1. Install Agent
  2. xiaohe server install && xiaohe server start
  3. xiaohe server pair → copy the xh_… key
  4. Open http://127.0.0.1:8110/ (or xiaohe webui --open)
  5. Settings → Connection → paste key → Test key → chat
    Details: Web UI

C. Desktop app on this machine​

  1. Install Agent and Client
  2. Same as B steps 2–3 (server start + pair)
  3. Open Client → Settings → Connection → Local → paste key → Test key → chat
    Details: Xiaohe Client

If replies fail with a provider error, configure a model on the Session host (xiaohe switch provider … or Settings → Assistant). See Agent CLI.

Three credentials​

Paste whereWhatPrefix
Connection (chat)Session API key from xiaohe server pairxh_
Authorization (desktop Pro)License from account centerxh_lic_
Authorization (MCP / Hub)MCP token from account centerxh_mcp_

Do not mix them. Hosted Session (https://agent.xiaohe.team) needs a key from your operator instead of local pair.