hermes model Command — Complete Reference & Examples

Overview

hermes model opens an interactive picker for your default inference provider and model. It is typically used with the Nous Portal OAuth flow. The flags below let you refresh the cached model list or customize the login endpoints.

Usage

hermes model [OPTIONS]

Options

Flag	Description
`--refresh`	Wipe the model picker disk cache and re-fetch every provider’s live `/v1/models` list.
`--portal-url URL`	Nous Portal base URL (default: production portal).
`--inference-url URL`	Inference API base URL (default: production inference API).
`--client-id ID`	OAuth client ID for Nous login (default: `hermes-cli`).
`--scope SCOPE`	OAuth scope to request for Nous login.
`--no-browser`	Do not open the browser automatically during Nous login.
`--timeout SECONDS`	HTTP request timeout for Nous login (default: 15).
`--ca-bundle PATH`	Path to a CA bundle PEM file for Nous TLS verification.
`--insecure`	Disable TLS verification for Nous login (testing only).

Examples

# Interactive provider/model picker
hermes model

# Refresh the model list before picking
hermes model --refresh

# Headless server: don't open a browser
hermes model --no-browser

# Use a custom portal/inference endpoint
hermes model --portal-url https://portal.example.com --inference-url https://api.example.com --no-browser

# Longer timeout for slow networks
hermes model --no-browser --timeout 30

Tips

Use --refresh if a newly released model does not appear in the picker.
--no-browser is essential on remote or headless machines; the URL is printed to the terminal instead.
--insecure is only for testing and should never be used with production credentials.