Install and update hi
hi runs on macOS with Apple silicon, on Linux on x64 and ARM64 (one static build for any distribution), and on Windows on x64; Windows on ARM runs the x64 build.
curl -fsSL https://hips.com/hi.sh | shhips.com/hi.sh and hips.com/hi.ps1 serve the newest release's own installer, byte for byte, and only once that release's list of SHA-256 sums carries HIPS's release key's signature. Open either address in a browser to read the script before you run it.
Step 1: The installer downloads the release's
SHA256SUMSand its signatureSHA256SUMS.sig, and checks the signature against HIPS's release key, which is written into the installer.Step 2: It downloads the program for your system and checks it against its SHA-256 in that list.
Step 3: Only then does it install it, into your own folders:
~/.local/binon macOS and Linux,%LOCALAPPDATA%\Programs\HIPS\hion Windows, which it puts on your userPATH.
Nothing runs as root or as an administrator. When a check fails, nothing is installed.
| Variable | What it does |
|---|---|
HI_VERSION | Installs that release, for example HI_VERSION=0.1.0, instead of the newest |
HI_INSTALL_DIR | Installs into that folder instead |
- Variable
HI_VERSION- What it does
- Installs that release, for example
HI_VERSION=0.1.0, instead of the newest
- Variable
HI_INSTALL_DIR- What it does
- Installs into that folder instead
The PowerShell installer gives the same codes when run as a file; piped into iex, it stops with the reason instead, so your window stays open
| Exit code | Meaning |
|---|---|
0 | Installed |
2 | HIPS publishes no release of hi for this system |
3 | A tool the shell installer needs is missing: curl, openssl or a SHA-256 tool |
4 | A download failed |
5 | The signature or a sum did not verify, so nothing was installed |
6 | The install folder could not be written |
- Exit code
0- Meaning
- Installed
- Exit code
2- Meaning
- HIPS publishes no release of
hifor this system
- Exit code
3- Meaning
- A tool the shell installer needs is missing:
curl,opensslor a SHA-256 tool
- Exit code
4- Meaning
- A download failed
- Exit code
5- Meaning
- The signature or a sum did not verify, so nothing was installed
- Exit code
6- Meaning
- The install folder could not be written
Shell
brew install hips-ai/tap/hiThe formula in the public tap hips-ai/homebrew-tap is committed by each release, filled in from the release's signed sums, for macOS on Apple silicon and Linux on x64 and ARM64. Homebrew updates it: brew upgrade hi.
Every release is published in the public repository github.com/hips-ai/hi-releases: the programs, install.sh, install.ps1, NOTICE, SHA256SUMS and SHA256SUMS.sig. Each release's notes say whether its macOS and Windows programs also carry Apple's and Microsoft's own code signatures.
Shell
hi update --checkhi updatehi updatedownloads the newest release for this system, checks itsSHA256SUMSagainst the release key built intohiand the download against its sum, and replaces itself in one step; on Windows it moves the running program aside first.hi update --checkonly says whether a newer release exists, and installs nothing.- A copy that a package manager installed is left to it:
hi updatenames the command that updates it, such asbrew upgrade hi.
| Address | When |
|---|---|
ai.hips.com | Every request: the models, the agents' requests, the sign-in's renewals |
eu.ai.hips.com | Signing in and out (/auth/device/*) |
console.hips.com/device | The link you open to approve a sign-in, in your browser |
raw.githubusercontent.com/hips-ai/hi-releases | At most once a day: the signed list of agent versions HIPS has tested (Coding agents) |
github.com/hips-ai/hi-releases | hi update |
| An agent vendor's installer | Only when you say yes to installing a missing agent |
- Address
ai.hips.com- When
- Every request: the models, the agents' requests, the sign-in's renewals
- Address
eu.ai.hips.com- When
- Signing in and out (
/auth/device/*)
- Address
console.hips.com/device- When
- The link you open to approve a sign-in, in your browser
- Address
raw.githubusercontent.com/hips-ai/hi-releases- When
- At most once a day: the signed list of agent versions HIPS has tested (Coding agents)
- Address
github.com/hips-ai/hi-releases- When
hi update
- Address
- An agent vendor's installer
- When
- Only when you say yes to installing a missing agent
hi sends no telemetry of its own: no install event, no check-in at launch and no machine identifier.
Related sheets
- Sheet
- 10 of 19
- Detail
- A
- Updated
- 2026-11-11