Skip to content
Gab AI
Sign inStart freeOpen app

Use Gab AI with Hermes Agent: setup, access and checks

Choose Gab models for Hermes conversations using interactive setup or a custom endpoint configuration.

Connect your client to Gab AI

Have your client installed and a Gab API key ready. Follow the configuration for your client below, then select a model and try a first prompt.

Prerequisites

  • Hermes Agent installed on your computer.
  • A Gab API key and the model ID you want to use.

Configure the endpoint in config.yaml

Alternatively, set the model provider to custom in ~/.hermes/config.yaml. Enter https://gab.ai/v1, the selected model ID and your key in the fields below. Keep credential files private.

~/.hermes/config.yaml
yaml
model:
  default: arya
  provider: custom
  base_url: https://gab.ai/v1
  api_key: YOUR_GAB_API_KEY

Use a current model ID or catalog alias

Copy the exact ID or an alias returned by /v1/models. Display names and guessed dotted/hyphenated spellings are not reliable. Check text/function-calling capability and map the ID in the client.

Choose a model for agent work

Select a model with function-calling support for tool workflows. Use the catalog’s exact IDs and capability fields when choosing text or image inputs.

List function-calling models
cURL
curl https://gab.ai/v1/models \
  -H "Authorization: Bearer YOUR_GAB_API_KEY" \
  | jq -r '.data[] | select(.capabilities.function_calling and .capabilities.text) | .id'

Choose capabilities for your workflow

Match the Gab model’s capabilities to the inputs and tools your client sends.

  • Chat Completions requests through the configured Gab provider.
  • Streaming and function calling with models that advertise those capabilities.
  • Image inputs when both the selected model and client support the requested format.

Troubleshooting

  • 401 authentication_error: re-run hermes model and re-paste your key with no leading or trailing whitespace.
  • 403 plus_required: the developer API requires an active Gab AI Plus subscription.
  • 400 invalid_model: the model name doesn't match a real Gab AI slug. Verify against /v1/models.
  • Empty or broken replies: confirm the base URL is https://gab.ai/v1 (with the /v1 suffix) and verify the endpoint with a curl request first.
  • 402 credits_exhausted: your account is out of credits — check GET /v1/credits.

Try a first prompt and follow-up

Select your configured Gab provider and model in Hermes Agent. Send the first prompt, then continue the same conversation with the follow-up.

First prompt for Hermes Agent
Text
For a workshop, income is USD 480 and base cost is USD 370. Reply with the remaining amount only.

Expected result: USD 110.

Follow-up prompt for Hermes Agent
Text
Change only the base cost to USD 395. Keep income at USD 480 and reply with the new remaining amount only.

Expected result after the change: USD 85.

Check the API connection separately

This cURL example checks Chat Completions directly. Use the in-client prompts above to check your Hermes Agent connection.

Try a small Chat Completions request
cURL
curl -sS https://gab.ai/v1/chat/completions \
  -H "Authorization: Bearer $GAB_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "model": "arya",
  "messages": [
    {
      "role": "user",
      "content": "For a workshop, income is USD 480 and base cost is USD 370. Reply with the remaining amount only, as USD 110."
    }
  ],
  "max_tokens": 1024,
  "stream": false
}'

API access and usage

Authenticated API requests require active Plus or Plus Premium and applicable credits. API use is billed separately from included in-app Chat. Daily request limits and credit balance are separate; the authentication reference explains allowances and reset times.

Resolve failed or incomplete requests

Read the client’s error and confirm its active provider, base URL and model. For key, account or rate-limit errors, use the authentication guide. If an answer stops early, inspect the completion status and output budget before retrying. For tool failures, check the selected model’s capabilities and the client’s tool configuration.

Was this page helpful?