talos provider

Keys are stored in the system credential store (or in memory for the session, if you choose so). A key is never printed. Choosing a model chooses its provider: see `talos model`. Every provider is in Providers.

Operation	What it does
listdefault	Lists the providers with the state of their key and the environment variable that can supply one.
login	Signs in to OpenRouter in the browser and saves the key it returns, after testing it.
set-key	Asks for a key without echoing it, tests it with a one-token request and saves it if it works.
env-key	Says whether a key for the provider was found in the environment, and whether TALOS uses it.
remove-key	Deletes the saved key of a provider.
configure	Sets the endpoint and/or the request timeout of a provider.
test	Checks that the provider answers, without generating tokens; prints its state, latency and what to do.

Without an operation, talos provider runs list.

list

Lists the providers with the state of their key and the environment variable that can supply one.

talos provider list

login

Signs in to OpenRouter in the browser and saves the key it returns, after testing it.

talos provider login openrouter [--paste]

Arguments

provider

Only openrouter supports sign-in.

Options

--paste

Paste the code OpenRouter shows instead of waiting for the browser (for remote sessions).

• Needs an interactive terminal.

Exit codes and errors6

Code	Exit	Meaning
exit	11	Sign-in failed, or the key did not pass the test and was not saved.
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.
PROVIDER_LOGIN_UNSUPPORTED	12	Only OpenRouter offers a sign-in; other providers use a key. Save a key with talos provider set-key <provider>.
PROVIDER_LOGIN_UNAVAILABLE	12	The OpenRouter sign-in is not available in this installation. Save a key with talos provider set-key openrouter.
LOGIN_REQUIRES_TTY	70	Signing in needs an interactive terminal. Run talos provider login openrouter in a terminal, or save a key with talos provider set-key openrouter.
SECRET_INPUT_REQUIRES_TTY	70	TALOS could not finish this action. Try again; if it happens again, keep the log for a report.

set-key

Asks for a key without echoing it, tests it with a one-token request and saves it if it works.

talos provider set-key <provider>

Arguments

provider

Provider id, as talos provider list shows it.

• Needs an interactive terminal. The test is announced before the key is read.

Exit codes and errors4

Code	Exit	Meaning
exit	11	The key did not pass the test and was not saved.
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.
SECRET_INPUT_REQUIRES_TTY	70	TALOS could not finish this action. Try again; if it happens again, keep the log for a report.
PROVIDER_KEY_TEST_UNAVAILABLE	11	The provider key could not be used. Check the key saved for this provider.

env-key

Says whether a key for the provider was found in the environment, and whether TALOS uses it.

talos provider env-key <provider> [--use | --decline]

Arguments

provider

Provider id.

Options

--use

Approve using the key found in the environment.

--decline

Decline it: TALOS will not use it.

• A key found in the environment is not used until you approve it. --use and --decline cannot be combined.

Exit codes and errors3

Code	Exit	Meaning
exit	2	--use or --decline was given but no key is in the environment.
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.
PROVIDER_INVALID	12	The model provider returned an error. Try again in a moment, or pick another model with /model.

remove-key

Deletes the saved key of a provider.

talos provider remove-key <provider>

Arguments

provider

Provider id.

Exit codes and errors1

Code	Exit	Meaning
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.

configure

Sets the endpoint and/or the request timeout of a provider.

talos provider configure <provider> [--endpoint <url>] [--timeout <seconds>]

Arguments

provider

Provider id.

Options

--endpoint <value>

Base URL of the provider API (e.g. a local server or a proxy).

--timeout <value>

Request timeout in seconds, 5 to 300.

• At least one of the two options is required.

Exit codes and errors3

Code	Exit	Meaning
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.
PROVIDER_TIMEOUT_INVALID	12	The model provider returned an error. Try again in a moment, or pick another model with /model.
PROVIDER_CONFIG_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.

test

Checks that the provider answers, without generating tokens; prints its state, latency and what to do.

talos provider test <provider>

Arguments

provider

Provider id.

Exit codes and errors2

Code	Exit	Meaning
exit	11	The provider is not available (for example, no key).
PROVIDER_REQUIRED	12	The model provider returned an error. Try again in a moment, or pick another model with /model.