Vux

Set up Vux

One command sets up your computer for Vux. You paste it and confirm in Vux.

  1. Copy the setup command

    Open Vux and tap Copy setup command. It ends with a one-time pairing link, valid for 15 minutes:

    curl -fsSL https://vux.dev/install.sh | sh -s https://vux.dev/pair/code
  2. Paste it into an agent or Terminal

    On the computer: give it to any agent (Hermes, Claude Code, Codex…) or paste it into Terminal. It installs Vux's own agent as a background service, gives it an HTTPS address with Tailscale and gets a ModelRelay key for speech. It asks you only for what it can't do itself, such as signing in. To use Hermes Agent instead, add --hermes after the pairing link: it turns on Hermes's API server. A Hermes already set up for Vux stays Hermes.

  3. Confirm in Vux

    When it says it's done, go back to Vux: it has received the agent's address and keys through vux.dev (they are deleted as soon as Vux picks them up). Vux asks you to confirm, then connects.

Use more than one computer

Setup installs on the computer where you run it. For each additional computer, open Settings in Vux, tap Add Computer, and run its fresh setup command on that computer. Each computer has its own connection.

Use an always-on computer for your main conversation. A closed or sleeping laptop cannot run work or accept requests; Vux reconnects when it comes back online.

Speech and voices

Vux streams your voice to Grok's speech-to-text, so your words are ready for your agent when you stop, and Gemini Flash speaks the reply sentence by sentence. ModelRelay serves both behind one key, from the team behind Vux. The setup command sets it up for you: you sign in from your phone, and new accounts come with free credit. Vux's own agent runs its model there too; Hermes keeps its own.

Settings › Voice also takes an OpenAI-compatible provider with your own key, such as OpenAI's. ModelRelay hears you while you talk, so replies come back quickest; OpenAI's voice starts a little sooner and handles code words better, but each turn waits for your recording to upload.

What you need

If Vux can't connect

“Can't reach …”
The agent or its HTTPS address is down. On the computer, check tailscale serve status, and the agent's log: ~/.vux-agent/agent.log on a Mac, journalctl --user -u vux-agent on Linux. Running the setup command again restarts the agent. With tailscale serve, your iPhone must be connected to Tailscale.
“… has no valid HTTPS certificate”
Turn on HTTPS certificates in the Tailscale admin console, then copy the setup command again and run it.
“That URL isn't an agent's API server”
The address points at something else. Copy the setup command again and run it.
“The agent rejected its API key”
The key changed, or this phone was removed (~/.vux-agent/phones revoke). Copy the setup command again and run it.
“ModelRelay rejected its API key” or no speech
Check the key and the account's credit at modelrelay.ai.

If Vux can't connect to Hermes

“Can't reach …”
Check hermes gateway status and tailscale serve status.
“That URL isn't an agent's API server”
The address points at something else, such as the Hermes dashboard. The API server listens on port 8642 by default.
“The agent rejected its API key”
The key changed, or this phone was removed (hermes vux revoke). Copy the setup command again and run it.

The command is install.sh; agents follow setup.md.