docs: document both Termux APT channels

termux.md only described the canary suite while release_artifacts.py and
the bundled-release workflow publish releases/termux/stable (suite
hermes-stable) for tagged releases. Lead with stable, show how to opt
into canary, and name the channels in the README instead of a bare
"prerelease".
This commit is contained in:
ethernet
2026-09-21 18:41:25 -04:00
parent fc0fc20603
commit e5fc42468e
2 changed files with 19 additions and 6 deletions

View File

@@ -56,7 +56,7 @@ for Windows archive in Hermes' tool store. It does not replace your system Git.
See [installation methods](https://hermes-agent.nousresearch.com/docs/getting-started/installation)
for the separate MSIX/App Installer package and its update ownership.
> **Android / Termux:** A prerelease APT package is available for aarch64 devices. It includes Python, Node.js, and the TUI. Use the [Termux guide](https://hermes-agent.nousresearch.com/docs/getting-started/termux), not the desktop/server installer script.
> **Android / Termux:** A signed APT repository is available for aarch64 devices, with a `stable` channel (tagged releases) and a prerelease `canary` channel. The package includes Python, Node.js, and the TUI. Use the [Termux guide](https://hermes-agent.nousresearch.com/docs/getting-started/termux), not the desktop/server installer script.
>
> **Windows:** Native Windows is fully supported — the PowerShell one-liner above installs everything. If you'd rather use WSL2, the Linux command works there too. Native Windows install lives under `%LOCALAPPDATA%\hermes`; WSL2 installs under `~/.hermes` as on Linux.

View File

@@ -7,7 +7,17 @@ description: "Install Hermes Agent on Android from its signed Termux APT reposit
# Hermes on Android with Termux
The Termux package runs Hermes on **aarch64 (arm64-v8a)** Android devices.
This package is in prerelease testing.
Two APT channels are published under
`https://hermes-assets.nousresearch.com/releases/termux/<channel>`:
| Channel | APT suite | Contents |
| --- | --- | --- |
| `stable` | `hermes-stable` | Tagged `vMAJOR.MINOR.PATCH` releases that passed the stable release gate |
| `canary` | `hermes-canary` | Prerelease builds from canary tags; versions carry `~canary.<timestamp>` |
The steps below use `stable`. To follow prereleases, replace `stable` with
`canary` and `hermes-stable` with `hermes-canary` in steps 2 and 4. Both
channels are signed with the same key.
The package includes Python, Node.js, npm, uv, ripgrep, ffmpeg, and their runtime libraries.
CI builds the native Python wheels and the TUI before it creates the package.
@@ -35,7 +45,7 @@ Do not use the desktop/server `install.sh` or a glibc Linux archive on this targ
```bash
mkdir -p "$PREFIX/etc/apt/keyrings"
curl -fsSL \
https://hermes-assets.nousresearch.com/releases/termux/canary/key.asc \
https://hermes-assets.nousresearch.com/releases/termux/stable/key.asc \
-o "$PREFIX/etc/apt/keyrings/hermes-agent.asc"
```
@@ -53,11 +63,11 @@ Do not use the desktop/server `install.sh` or a glibc Linux archive on this targ
If the fingerprint differs, stop. Do not disable signature verification.
4. Add the canary repository:
4. Add the repository:
```bash
printf '%s\n' \
"deb [signed-by=$PREFIX/etc/apt/keyrings/hermes-agent.asc] https://hermes-assets.nousresearch.com/releases/termux/canary hermes-canary main" \
"deb [signed-by=$PREFIX/etc/apt/keyrings/hermes-agent.asc] https://hermes-assets.nousresearch.com/releases/termux/stable hermes-stable main" \
> "$PREFIX/etc/apt/sources.list.d/hermes-agent.list"
```
@@ -95,7 +105,10 @@ pkg upgrade hermes-agent
`hermes update` refuses to modify an APT-owned installation.
It prints the package-manager command instead.
Canary versions contain `~canary.<timestamp>` and sort before the corresponding stable version.
Canary versions contain `~canary.<timestamp>` and sort before the corresponding
stable version. Each suite only lists its own channel's packages; to move
between channels, edit the channel path and suite in `hermes-agent.list`, then
`pkg update && pkg upgrade hermes-agent`.
## Gateway