Skip to main content
1

Install the CLI

Install the RELAI CLI with the standalone installer for macOS or Linux.
2

Configure credentials

Run setup after installing. It checks prerequisites, asks for your RELAI API credentials, and saves your theme in ~/.relai/config.toml. It also installs plugins for any detected coding agents (Codex or Claude Code).
The default API URL is https://api.relai.ai.
Create or manage CLI keys from the API keys page. Never paste or commit API keys.

​
Prerequisites

RELAI supports Python agents, plus TypeScript and Go agents experimentally. relai setup --check (see setup) audits the requirements for Python and TypeScript agents.
Required for every project:
  • git — your project must be a git repository with at least one commit. Install
  • Bash — used by generated simulator scripts. Recommended for optimizer pull requests:
  • gh — enables automatic optimizer PRs. Install
RELAI is in beta. For adapter capability requirements, constraints, and known limitations, see Compatibility.
Installed and configured? Next:

Quickstart

Run the loop on your own agent: init → learning-env → simulate → optimize.

Try the sample agent

No project of your own yet? Walk the same loop in your browser.