Skip to content

Install

Gray is two pieces: the app (iPhone and Android) and the box (your self-hosted server). The app is a remote control — it needs a box to talk to.

Gray for iPhone and Android — on the App Store and Google Play at launch.

Any Linux machine you can SSH into works — a $5 VPS, a home server, a spare laptop. It needs:

  • Linux with Python 3.11+ (the installer handles dependencies)
  • Tailscale — how your phone reaches the box privately
  • Claude on the box — required. Gray’s voice runs on Claude: run claude once on the box and sign in (subscription works), or set ANTHROPIC_API_KEY.
  • Any other model logins you already use (Codex/OpenAI, Grok/xAI, Gemini…) — detected automatically; Gray’s crew can drive those CLIs. They don’t power Gray’s own voice — see Models & keys

Set it up in about five minutes: Set up your box.

Onboarding runs account-first: create your account (email and a 6-digit code), then connect the box with the address and box code its installer printed, then Gray scans it and shows what it found. The details: Sign in.

Nothing beyond your own box — download the app, connect, and use it. Plan options live in the app.