Environment variables
API keys
Section titled “API keys”Gluon takes a provider’s key from the .env file next to the config (what gluon setup saved) or, failing that, from the environment. A launched agent gets only its model’s provider key. Subscriptions use each agent’s own login and need no variable.
| Variable | Provider | Used by | Create a key at |
|---|---|---|---|
ANTHROPIC_API_KEY |
Anthropic | Claude Code | https://console.anthropic.com/settings/keys |
OPENAI_API_KEY |
OpenAI | Codex | https://platform.openai.com/api-keys |
GEMINI_API_KEY |
Gemini API | Antigravity | https://aistudio.google.com/apikey |
XAI_API_KEY |
xAI | Grok Build | https://console.x.ai |
MOONSHOT_API_KEY |
Moonshot AI | Kimi Code | https://platform.moonshot.ai/console/api-keys |
OPENROUTER_API_KEY |
OpenRouter | Claude Code, Codex, OpenCode, Kimi Code | https://openrouter.ai/settings/keys |
Amazon Bedrock takes no key: it uses your AWS profile and region (below).
Config location
Section titled “Config location”| Variable | Meaning |
|---|---|
GLUON_CONFIG |
Path of config.yaml (routing.yaml and the saved keys move with it); a relative path is made absolute from the directory Gluon starts in. |
XDG_CONFIG_HOME |
Moves the config directory: $XDG_CONFIG_HOME/gluon/config.yaml; a relative path is ignored, as the XDG spec says. On Windows the default is %APPDATA%. |
Amazon Bedrock
Section titled “Amazon Bedrock”Used when bedrock.profile or bedrock.region is unset in config.yaml:
| Variable | Meaning |
|---|---|
AWS_PROFILE |
The AWS profile for Bedrock. |
AWS_REGION |
The region (wins over AWS_DEFAULT_REGION); when neither is set, the profile’s region in your AWS config, else us-east-1. |
AWS_CONFIG_FILE |
Where Gluon reads the AWS config’s region from, instead of ~/.aws/config (that key only). |
AWS_DEFAULT_REGION |
The region, when AWS_REGION is not set. |
Installer
Section titled “Installer”Read from the header comments of install.sh (Linux, macOS) and install.ps1 (Windows):
| Variable | install.sh | install.ps1 |
|---|---|---|
GLUON_ADD_TO_PATH |
n/a | 1: add the install directory to the user PATH (same as -AddToPath) |
GLUON_INSTALL_DIR |
where to install (default: ~/.local/bin) | where to install (default: %LOCALAPPDATA%\Programs\gluon) |
GLUON_RELEASE_URL |
where the release files are: an https:// base URL, a file:// URL or a local directory holding gluon-bun-<os>-<arch>[-musl] and SHA256SUMS. It wins over GLUON_VERSION. | where the release files are: an https:// base URL, a file:// URL or a local directory holding gluon-bun-windows-x64.exe and SHA256SUMS. It wins over GLUON_VERSION. |
GLUON_VERSION |
a version such as 1.0.0 (default: latest, the newest published GitHub release of fidipro/gluon) | a version such as 1.0.0 (default: latest, the newest published GitHub release of fidipro/gluon) |