Skip to content
Gormes Docs

Termux

Termux is supported as a no-root Android arm64/aarch64 runtime for PC-like Gormes operator workflows. Use it for setup, short CLI/TUI turns, gateway control, notes, and operator review. Put heavy browser automation, GPU/local model inference, Docker builds, and large go test ./... runs on a workstation or server reached over SSH.

Install

Section titled “Install”
Terminal window
curl -fsSL https://gormes.ai/install.sh | bash
gormes version
gormes doctor --offline --json
gormes config check

On Termux, install.sh detects TERMUX_VERSION or the standard Termux $PREFIX path and publishes the command to $PREFIX/bin/gormes. The release asset is android-arm64, not linux-arm64.

Termux/Android status: v0.2.22 carries forward the installer recovery for the v0.2.20 executable-argument issue. If you saw unknown command /data/data/com.termux/files/usr/bin/gormes for gormes, reinstall from the latest release, then verify with gormes version and gormes doctor --offline.

Only source fallback or contributor builds need the build toolchain:

Terminal window
pkg update
pkg install git golang clang tmux openssh curl jq sqlite

First smoke test

Section titled “First smoke test”

If provider credentials are configured:

Terminal window
gormes chat -q "hello from Termux"

For long gateway sessions, use the foreground/tmux model:

Terminal window
tmux new -s gormes-gateway
termux-wake-lock  # optional best-effort aid
gormes gateway

Use another Termux shell to inspect or stop the runtime:

Terminal window
gormes gateway status
gormes gateway stop

Android battery optimization can still stop background processes. Gormes does not install or manage Android services automatically.

Termux as controller

Section titled “Termux as controller”

Set a shell shortcut for the host you use most:

Terminal window
export GORMES_REMOTE_HOST=workstation
ssh workstation 'gormes doctor --offline'

Use tmux on the remote machine for long-running builds and browser sessions:

Terminal window
ssh -t "$GORMES_REMOTE_HOST" 'tmux new -A -s gormes-build'
cd ~/code/gormes-agent
go test ./...

Run one-off remote agent turns from Termux with the existing scripted-chat surface:

Terminal window
ssh "$GORMES_REMOTE_HOST" 'cd ~/code/gormes-agent && gormes chat -q "summarize the current failing tests"'