Inicio rápido
Step 1: Instalar Hermes
Abre la terminal y ejecuta el siguiente comando:Linux / macOS / WSL2
Android / Termux
No es compatible con Windows nativo; instala WSL2 y ejecuta Hermes Agent desde WSL2.
Step2: Elegir proveedor
Tras la instalación correcta, selecciona Quick setup -> More providers -> Custom endpoint.
Step3: Configurar los parámetros de AIHubMix
- Introduce la API base URL:
https://aihubmix.com/v1. - Introduce la AIHUBMIX_API_KEY: sk-***.
- Introduce el identificador del modelo y selecciona el modelo que deseas usar.
Step 4: Configurar la plataforma de mensajería
Configura la plataforma de mensajería según tus necesidades (usa Skip como referencia) -> ¿Quieres ejecutarlo? (elige Y)
Step 5: Ejecutar la prueba
- Escribe
hermesen la terminal para acceder a la página interactiva de Hermes Agent.
- Escribe contenido en el cuadro de diálogo; si el modelo responde con normalidad, significa que la instalación se ha realizado con éxito.
Conectar mediante el plugin oficial
El método Custom endpoint descrito arriba obliga a escribir la base URL y el identificador de modelo cada vez. AIHubMix ofrece un plugin oficial de model provider (proveedor de modelos): una vez instalado, AIHubMix queda registrado en Hermes como el proveedoraihubmix y se puede invocar directamente con --provider aihubmix. La lista de modelos se rellena automáticamente desde la interfaz de catálogo de modelos de AIHubMix. El plugin no modifica ningún archivo del núcleo de Hermes.
Código fuente y documentación completa: AIhubmix/hermes-provider-aihubmix
Instalación
Copie el directorio del plugin al directorio de model providers de Hermes:hermes plugins enable aihubmix, que los inscribe en plugins.enabled y los activa.
hermes plugins install AIhubmix/hermes-provider-aihubmix no funciona con este plugin. Ese comando lo instala en ~/.hermes/plugins/<nombre-del-repositorio>/ y advierte de que la raíz del repositorio no contiene plugin.yaml, mientras que los model providers solo se detectan en ~/.hermes/plugins/model-providers/, por lo que el plugin no llega a registrarse. El manifiesto aihubmix/plugin.yaml declara kind: model-provider, pero el comando no lee ese campo al elegir el directorio de instalación. Utilice uno de los dos métodos anteriores. Este comportamiento se ha verificado en Hermes 0.20.5.Configurar la API Key
hermes setup lee esta variable de entorno y hermes doctor la usa para comprobar la conectividad con la interfaz de catálogo de modelos.
Uso
/model tras seleccionar AIHubMix.
La lista de modelos procede de la interfaz de catálogo de modelos de AIHubMix e incluye solo las entradas marcadas con tools o function_calling; basta con una de las dos marcas. Si esa interfaz no está disponible, el plugin recurre a la lista genérica de /v1/models; si tampoco lo está, usa una lista de reserva reducida incluida en el propio plugin.
Con AIHUBMIX_BASE_URL se puede apuntar a un proxy o a un servicio de reenvío propio. Cuando ese valor difiere de la dirección predeterminada, el plugin obtiene la lista de modelos por la ruta genérica {base_url}/models.
Comandos habituales
Bloque de códigoPreguntas frecuentes
¿Por qué no funciona el plugin después de hermes plugins install?
Ese comando instala el plugin en ~/.hermes/plugins/<nombre-del-repositorio>/, mientras que Hermes solo detecta los model providers en ~/.hermes/plugins/model-providers/, por lo que el plugin no se registra. El manifiesto aihubmix/plugin.yaml declara kind: model-provider, pero el comando no lee ese campo al elegir el directorio de instalación, así que la instalación se muestra como correcta. Utilice la copia de directorio indicada arriba, o instale con pip y ejecute hermes plugins enable aihubmix.
¿En qué se diferencia el plugin del método Custom endpoint?
Custom endpoint exige escribir manualmente la base URL y el identificador de modelo. El plugin registra AIHubMix como el proveedor con nombreaihubmix, lo que permite invocarlo directamente con --provider aihubmix; la lista de modelos se rellena automáticamente desde la interfaz de catálogo de modelos de AIHubMix y se filtra a los modelos que admiten llamadas a herramientas.
¿Qué hago si la lista de modelos de /model sale vacía o muy corta?
Compruebe primero con hermes doctor que AIHUBMIX_API_KEY está definida y es válida. La lista solo incluye modelos marcados con tools o function_calling, por lo que es más corta que el catálogo completo. Si AIHUBMIX_BASE_URL está definida y difiere de la dirección predeterminada, el plugin obtiene la lista por {base_url}/models.
Última actualización: 2026-08-25