![\"herdr-web\"](\"assets/logo.png\"){kind=logo}
\n\n \n
\n English · 简体中文\n
\n\nA terminal in your browser, built for running [`herdr`](https://github.com/zbysir/herdr).\nOne Go binary with the frontend baked in. Works on phones.\n\n**Voice compose** is the point of this project: dictate on a tablet, select the words that came out\nwrong and say them again, then hand the whole paragraph to an agent's input line. A phone is enough\nto get by; a tablet in landscape gives you 211 columns — that is a workstation.\n\nThis document covers **installing, using and configuring** it. Why each thing works the way it does,\nand what it cost to learn, lives in the [documents listed at the end](#documents) — those are the\nreal substance of this project. They are in Chinese.\n\n## Install\n\n```bash\nnpm install -g @bysir/herdr-web # easiest if you have node; upgrades come free\nherdr-web # listens on 127.0.0.1 only\n```\n\nNo node (common on servers):\n\n```bash\ncurl -fsSL https://raw.githubusercontent.com/zbysir/herdr-web/master/install.sh | sh\n```\n\nInstalls into `~/.local/bin`. To install somewhere else, the variable has to go to `sh`, **not** to `curl`:\n\n```bash\ncurl -fsSL …/install.sh | HERDR_WEB_INSTALL_DIR=/opt/bin sh # right\nHERDR_WEB_INSTALL_DIR=/opt/bin curl -fsSL …/install.sh | sh # wrong — curl gets it, the script never sees it\n```\n\nThe wrong one **does not fail**; it quietly installs to the default directory. Same shape for `HERDR_WEB_INSTALL_VER=v0.1.0` to pin a version.\n\nThe installer **always verifies sha256** and refuses to install if neither `sha256sum` nor `shasum` exists — there is a login shell behind this thing.\n\nOther ways in:\n\n```bash\nmake build && ./herdr-web # from source (frontend → internal/webui/dist → go build)\nHERDR_WEB_HOST=0.0.0.0 ./herdr-web # listen on the LAN, and print a QR code for your phone\n```\n\n`go install github.com/zbysir/herdr-web/cmd/herdr-web@latest` works too, but **what you get has no frontend**: the web assets are produced by `make build` and embedded, and they are not in the repo, so `go install` can't see them. That binary is only useful with `--web