Overview
Two pieces. Local chat needs both.
| What it is | |
|---|---|
| Agent | The engine — xiaohe in a terminal, plus a local server the window talks to |
| Client | The window — desktop chat app |
Installers: Download. Details: Install.
Fastest path: chat in the desktop app
- Install Agent and Client from the download page.
- Open a new terminal and finish Agent setup:
xiaohe init
Run it again if anything was skipped.
- Start the local server and copy the chat key (
xh_ses_…):
xiaohe server install
xiaohe server start
xiaohe server pair
- Open Client → Settings → Connection → Local → paste the key → Test key → new session → chat.
If replies fail, pick a model on this machine: Settings → Assistant, or xiaohe switch provider. More: Client.
Other paths
Terminal only — install Agent, then xiaohe init, then xiaohe. See Agent CLI.
Browser on this computer — same as the desktop path through pair, then open http://127.0.0.1:8110/ (or xiaohe webui --open) instead of Client. See Web UI.
Three keys — do not mix them
| Paste where | What | Looks like |
|---|---|---|
| Settings → Connection | Chat access, from xiaohe server pair | xh_ses_… |
| Settings → Authorization (desktop Pro) | License from the account center | xh_lic_… |
| Settings → Authorization (Skills Hub) | MCP token from the account center | xh_cld_… |
A hosted Session (https://agent.xiaohe.team) uses a key from your operator, not local pair.
Related
- Install & update · Client · Web UI · CLI · Session API