Hermes Agent con Muapi

Configura Muapi come endpoint personalizzato compatibile con OpenAI per usare i modelli testuali in Hermes Agent.

1. Crea una chiave e scegli un modello

Crea una chiave API nella dashboard Muapi e mostra i modelli disponibili:

curl -s "https://api.muapi.ai/v1/models?type=text" \
  -H "Authorization: Bearer $MUAPI_API_KEY"

Scegli un modello con capabilities.tools: true. I flussi agent di Hermes richiedono una finestra di contesto di almeno 64.000 token; controlla il limite del modello.

2. Configura Hermes Agent

Avvia la procedura guidata:

hermes model

Scegli Custom endpoint e inserisci URL base https://api.muapi.ai/v1, chiave API Muapi e ID modello esatto.

In alternativa, configura ~/.hermes/config.yaml:

model:
  default: YOUR_MODEL_ID
  provider: custom
  base_url: https://api.muapi.ai/v1
  key_env: MUAPI_API_KEY

Salva la chiave in ~/.hermes/.env:

MUAPI_API_KEY=your-muapi-api-key

Sostituisci YOUR_MODEL_ID con l’ID esatto restituito da Muapi.

3. Avvia Hermes Agent

hermes
# Oppure:
hermes --tui

Prova una piccola attività che utilizza uno strumento. Quando il modello funziona, collega le piattaforme di messaggistica con hermes gateway setup.

Risoluzione dei problemi

• Verifica che l’URL termini con /v1, la chiave sia disponibile e l’ID modello sia esatto.
• Per l’uso degli strumenti scegli un modello con capabilities.tools: true.
• Hermes richiede un contesto di almeno 64K token.
• Inizia con un’attività breve e controlla i consumi nella dashboard Muapi.

Consulta la documentazione provider Hermes e la guida di configurazione.