Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.inference.net/llms.txt

Use this file to discover all available pages before exploring further.

The CLI supports two auth modes: browser-based session login for interactive use and a project API key for CI and headless environments.

​
inf auth login

Sign in through your browser using the OAuth 2.0 device authorization flow. Opens a verification URL, displays a user code, and polls until you approve in the browser. 
inf auth login
After sign-in, the CLI stores a session token in ~/.inf/config.json and auto-selects an organization (team). If you have more than one project, run inf project list and inf project switch <id> to pick one.
Session login requires a browser, so inf auth login is not suitable for CI or other headless environments. Use inf auth set-key or the INF_API_KEY env var there instead.

​
inf auth set-key

Store a project API key on disk for headless or CI authentication. 
inf auth set-key <key>

​
Arguments

ArgumentRequiredDescription
keyYesA project API key (starts with sk-inference-)
After saving, the CLI validates the key by fetching the project list. A successful fetch auto-selects the first project as active.

​
Example

inf auth set-key sk-inference-...

​
inf auth status

Show who you’re signed in as, which auth method the CLI is using, the active team and project, and the API URL. 
inf auth status

​
inf auth logout

Sign out, clear the session token / API key from ~/.inf/config.json, and forget the active project and team. 
inf auth logout

​
Credential resolution order

When multiple credentials are present, the CLI picks the first match:
  1. INF_API_KEY environment variable
  2. API key stored via inf auth set-key
  3. Session token stored via inf auth login
inf instrument is the one exception — it rejects INF_API_KEY and requires a session login, because it needs to fetch your project’s default API key on your behalf. Unset INF_API_KEY and run inf auth login before running inf instrument.

​
Configuration

The CLI stores configuration at ~/.inf/config.json, created automatically on first login. Tokens are stored with 0600 permissions.

​
Environment variables

VariableDescriptionDefault
INF_API_KEYAPI key for authentication. Takes precedence over stored credentials—
INF_API_URLOverride the API base URLhttps://observability-api.inference.net
INF_PROJECT_IDOverride the active project for any invocation (equivalent to --project <id> global)—