Skip to content
Gormes Docs

Connect a provider and open chat

Connect a provider and open chat

Section titled “Connect a provider and open chat”

Outcome: Provider-backed chat opens from the shell, proving credentials and routing work.

Prerequisites: gormes installed; an API key for one of: OpenAI, Anthropic, DeepSeek, Groq, OpenRouter, OpenAI Codex.

Steps

Section titled “Steps”

  1. Add a provider credential

    Terminal window
    gormes auth add openai --api-key sk-...

    Replace openai with your provider id (anthropic, deepseek, groq, openrouter, codex, …). The key is written to ~/.gormes/.env, never echoed back.

  2. Confirm auth status

    Terminal window
    gormes auth list

    You should see a row with auth_type=api_key and status=ok.

  3. Start chat

    Terminal window
    gormes chat

    The default provider/model resolves from your config.

Verify

Section titled “Verify”
Terminal window
gormes chat -q "say hi in three words"

Expected output: a short model reply on stdout, then the query exits with status 0.

Troubleshooting

Section titled “Troubleshooting”
  • Not Found: model 'xxx' not found → The configured model is not available on this provider. Run gormes setup model, or set the model with gormes config set hermes.model <id>.
  • accepts 1 arg(s), received 0 → gormes auth add needs the provider name. Re-run gormes auth add <provider> --api-key ....
  • Auth status=invalid or status=missing → See provider setup.

See also

Section titled “See also”