Environment Variables - HoneyHive AI Docs

The CLI reads the following environment variables. All are optional, and each can be overridden by a root-level flag, which takes precedence over its environment variable.

Configuration

Variable	Description	Default	Override flag
`HH_PROJECT_API_KEY`	Project API key for authenticating with HoneyHive.	None (required)	`--project-api-key <key>`
`HH_DATA_PLANE_URL`	Base URL for the Data Plane API.	`https://api.dp1.us.honeyhive.ai`	`--data-plane-url <url>`
`HH_VERBOSE`	Set to `"true"` (case-insensitive) to log the resolved data plane URL, a masked API key, and the CLI version on startup.	`false`	`--verbose`

An empty string is treated the same as unset, so HH_PROJECT_API_KEY= honeyhive ... falls back to the default (or errors, for the required API key).

Deprecated aliases

These names are still accepted but will be removed in the next major version. Using any of them logs a deprecation warning to stderr.

Deprecated	Replacement
`HH_API_KEY`	`HH_PROJECT_API_KEY`
`HH_API_URL`	`HH_DATA_PLANE_URL`
`--api-key <key>`	`--project-api-key <key>`
`--base-url <url>`	`--data-plane-url <url>`

Resolution runs new flag → deprecated flag → new environment variable → deprecated environment variable, so a deprecated name only takes effect when no current one resolved. A deprecated flag warns whenever you pass it, even when its replacement wins resolution, so a script passing both is still told to drop the old one.

There is no HONEYHIVE_* prefix in the CLI. Unlike the Python SDK, only the HH_* names above are recognized.

⌘I