Set up Vux
One command sets up your computer for Vux. You paste it and confirm in Vux.
-
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
-
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
--hermesafter the pairing link: it turns on Hermes's API server. A Hermes already set up for Vux stays Hermes. -
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
- Vux on your iPhone, from the App Store.
- A Linux or macOS computer you control, with or without Hermes Agent.
- Tailscale on that computer, and on your iPhone too, signed in to the same account.
- A ModelRelay account for speech. The setup can create one with you.
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.logon a Mac,journalctl --user -u vux-agenton Linux. Running the setup command again restarts the agent. Withtailscale 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 statusandtailscale 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.