Use AIsa in Hermes Agent

Use AIsa in Hermes Agent with one model endpoint and one API key. AIsa endpoint:

https://api.aisa.one/v1

Prerequisites

Before you start, make sure you have:

An AIsa API key
A terminal on macOS, Linux, or Windows WSL2

1. Install Hermes Agent

Run the official installer:

curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash

Reload your shell:

source ~/.zshrc

Verify the installation:

hermes doctor

2. Add AIsa as the model provider

Run:

hermes model

Hermes will ask you to choose a model provider. Select:

Custom Model / OpenAI-compatible endpoint

Select Custom Model / OpenAI-compatible endpoint

This lets Hermes connect to AIsa through AIsa’s OpenAI-compatible API.

2.1 Configure AIsa endpoint

When Hermes asks for the API endpoint and API key, enter:

API base URL: https://api.aisa.one/v1
API key: YOUR_AISA_API_KEY

If the endpoint is valid, Hermes will show that it can access the model list from AIsa:

Verified endpoint via https://api.aisa.one/v1/models
167 model(s) visible

2.2 Choose API mode

Pick mode 1. Auto-detect or 2. Chat Completions — both work, since the base URL ends in /v1. Mode 2 is recommended because it’s explicit and easier to debug.

Mode	Required base URL	Use for
1. Auto-detect	`https://api.aisa.one/v1`	Resolves to Chat Completions for `/v1` URLs
2. Chat Completions	`https://api.aisa.one/v1`	Standard OpenAI-compatible endpoints
3. Responses / Codex	`https://api.aisa.one/v1`	Codex CLI and reasoning models needing server-side state
4. Anthropic Messages	`https://api.aisa.one/` (no `/v1`)	Claude Code and other Anthropic-native clients

If you pick mode 4, go back to step 2.1 and remove /v1 from the base URL — Anthropic clients append /v1/messages themselves.

2.3 Choose a model

Hermes will show the available model list. You can either enter the model number or type the model name directly:

Select model [1-167] or type name: gpt-5

Choose a text, reasoning, or coding model. Do not choose image, video, embedding, Whisper, or TTS models as the main Hermes model.

2.4 Set context length

When Hermes asks:

Context length in tokens [leave blank for auto-detect]:

Press Enter to leave it blank.

3. Connect AIsa capabilities and start using

After the model provider is configured, start Hermes:

hermes

Then paste this prompt into Hermes:

Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.

Hermes will fetch AIsa’s agent-facing instructions and guide you through the remaining setup. After that, you can start using Hermes with AIsa models and capabilities. Try:

Use AIsa capabilities to search the web and summarize the latest information about Hermes Agent.

Quick reference

Item	Value
Provider type	`Custom Model / OpenAI-compatible endpoint`
API base URL	`https://api.aisa.one/v1`
API mode	`2. Chat Completions`
Context length	Leave blank for auto-detect
Capability setup prompt	`Read https://aisa.one/docs/agent-quickstart.md and help me safely connect, configure, and use AIsa's APIs, Skills, and LLMs in this agent environment.`

Troubleshooting

Problem	Fix
`hermes: command not found`	Run `source ~/.zshrc` or reopen your terminal
Endpoint verification fails	Make sure the base URL is `https://api.aisa.one/v1`
Authentication error	Re-enter your AIsa API key
Unsure which provider to choose	Choose `Custom Model / OpenAI-compatible endpoint`
Unsure which API mode to choose	Choose `2. Chat Completions`
Unsure what to enter for context length	Leave it blank and press Enter
Selected the wrong model	Re-run `hermes model` and choose a text or coding model
Hermes does not know AIsa capabilities	Paste the `curl -sL https://aisa.one/docs/llms.txt` prompt into Hermes

Use AIsa in OpenClaw

Configure another agent runtime with the OpenClaw setup path.

Authentication

API key creation, rotation, and storage best practices.

Model Catalog

Browse supported models before choosing a Hermes default.

AIsa Documentation

Tutorials

Pricing

Dashboard

Learn

Compare

Agent Discovery

Changelog

Use AIsa in Hermes Agent

Prerequisites

1. Install Hermes Agent

2. Add AIsa as the model provider

2.1 Configure AIsa endpoint

2.2 Choose API mode

2.3 Choose a model

2.4 Set context length

3. Connect AIsa capabilities and start using

Quick reference

Troubleshooting

Use AIsa in OpenClaw

Authentication

Model Catalog

​Prerequisites

​1. Install Hermes Agent

​2. Add AIsa as the model provider

​2.1 Configure AIsa endpoint

​2.2 Choose API mode

​2.3 Choose a model

​2.4 Set context length

​3. Connect AIsa capabilities and start using

​Quick reference

​Troubleshooting

​Related

Use AIsa in OpenClaw

Authentication

Model Catalog

Prerequisites

1. Install Hermes Agent

2. Add AIsa as the model provider

2.1 Configure AIsa endpoint

2.2 Choose API mode

2.3 Choose a model

2.4 Set context length

3. Connect AIsa capabilities and start using

Quick reference

Troubleshooting

Related