Skip to main content

Command not found

Add the install directory to your current shell path.
export PATH="$HOME/.local/bin:$PATH"
$env:Path = "$env:LOCALAPPDATA\Programs\Breeze\bin;$env:Path"

Login does not open a browser

Print the authorization URL and open it manually.
breeze login --no-browser

Saved key is missing

Check the active profile and log in again if the profile has no key.
breeze config show
breeze login

Authentication failed

An auth error, exit code 3, means the active profile has no key, or its key is missing, expired, or does not match the profile’s API environment. Confirm the resolved base URL and key source, then log in again or set a key for the right environment.
breeze diagnostics --agent
breeze login

Not enough credits

A quota error, exit code 4, means the account balance is too low for the request. Check the balance and top up before retrying.
breeze balance

Request timed out

A timeout error, exit code 5, means the request did not finish within the timeout window. Raise --timeout for slow networks or large generations, then retry.
breeze tts "Hello from Breeze" -o hello.wav --timeout 3m

Network or upstream failure

A network error, exit code 6, covers connection failures and temporary upstream errors, including upstream 5xx responses. These are usually transient. Confirm connectivity and retry after a short wait. The same code is returned when breeze update cannot reach the release manifest.
breeze diagnostics --agent

Update fails

breeze update --check returns a network error, exit code 6, when the release manifest is unreachable. Confirm network access and retry. The manifest URL can be overridden with --manifest-url for internal or pinned channels.
breeze update --check

Video Lab dependencies

Doctor reports missing local tools before rendering. It runs these local checks without a Breeze login or credits. Install the missing dependency, then rerun doctor.
breeze video doctor --agent
See Scripting and agents for the full exit code table and machine-readable error envelopes.