AIRelays Docs¶
AIRelays is a local OpenAI-shaped relay with provider-scoped runtimes.
- OpenAI runtime: ChatGPT subscription access with multi-account balancing, plus image generation and edits (
gpt-image-2) - Claude runtime: chat, completions and Responses with images, files, conversations and tool calls, balanced across AIRelays-owned
claudeCLI subscription profiles, separate from your personal Claude Code sign-in

Generated through AIRelays with POST /v1/images/generations; the request is
in API Notes.
Install the headless relay and CLI (macOS, Linux):
curl -fsSL https://raw.githubusercontent.com/lpalbou/AIRelays/main/scripts/install-headless.sh | bash
Install the desktop tray app (macOS Apple Silicon, Linux x86_64):
curl -fsSL https://raw.githubusercontent.com/lpalbou/AIRelays/main/scripts/install-desktop.sh | bash
On Windows (x64), run irm https://raw.githubusercontent.com/lpalbou/AIRelays/main/scripts/install-desktop.ps1 | iex
in PowerShell. See the repository README for details.
Start with: