快速开始

目标:5 分钟内让 HnsX 跑起来,完成一次端到端 Session。

前置条件

  • macOS / Linux / WSL
  • Docker & Docker Compose(用于本地 Postgres + Server + Worker)
  • Node 20+ 和 pnpm(用于控制台)
  • Go 1.22+(用于源码构建 server / CLI)

1. 安装 CLI

curl -sSL hnsx.dev/install.sh | sh

macOS 用户也可以:

brew install narcilee7/hnsx/hnsx

2. 启动本地全栈

cd deployments/local
docker compose up -d

这会拉起 Postgres、HnsX Server、Worker,以及可选的 Tempo + Grafana。

3. 触发第一个 Session

hnsx try customer-service

如果一切正常,你会看到一次完整的客服分诊 Session:Trigger → Session → Turn → Observation。

4. 查看 Trace

hnsx trace list
hnsx trace show <trace-id>

或者在浏览器打开 http://127.0.0.1:50052 进入控制台。

下一步