Hermes Agent es una herramienta de codificación con IA para terminal que se conecta a Alibaba Cloud Model Studio mediante Pago por uso, Coding Plan, Token Plan Personal Edition o Token Plan Team Edition.
Instalar Hermes Agent
- Ejecute este comando para instalar Hermes Agent. El script instala automáticamente dependencias como Python y Git.
curl -fsSL https://raw.githubusercontent.com/NousResearch/hermes-agent/main/scripts/install.sh | bash
NotaWindows no admite la instalación nativa. Instale primero WSL2 y luego ejecute el comando anterior en WSL2.
- Después de la instalación, recargue el entorno de la terminal.
source ~/.bashrc # If using zsh, change to source ~/.zshrc
- Verifique la instalación. Un número de versión confirma el éxito.
hermes --version
Configuración de credenciales de acceso
Ejecute hermes config set para configurar la URL base y la clave API para el plan elegido:
- Token Plan Personal Edition: Una suscripción personal que descuenta Créditos personales según el consumo de tokens.
- Token Plan Team Edition: Suscripción basada en asientos; el consumo de tokens descuenta Créditos.
- Coding Plan: Suscripción mensual fija, medida por recuento de invocaciones de modelos.
- Pago por uso: Pago posterior basado en el uso real.
NotaLos ejemplos de este tema utilizan el protocolo compatible con Anthropic: la URL base termina con /apps/anthropic y api_mode se establece en anthropic_messages. Hermes Agent también admite el protocolo compatible con OpenAI: reemplace el /apps/anthropic final en la URL base con /compatible-mode/v1 y elimine la configuración de api_mode. Por ejemplo, la URL base compatible con OpenAI para Pago por uso (China North 2, Beijing) es https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/compatible-mode/v1.
Además de la versión de línea de comandos, Hermes Agent también ofrece una versión de escritorio (Hermes Desktop). Puede descargar el instalador desde el sitio web de Hermes, o ejecutar hermes desktop después de instalar la versión de línea de comandos. Hermes Desktop y la versión de línea de comandos comparten el mismo archivo de configuración ~/.hermes/config.yaml, por lo que los parámetros de acceso son idénticos a los descritos aquí. Al conectarse a través de un Custom Endpoint en la aplicación de escritorio, utilice la Base URL compatible con OpenAI descrita anteriormente.
Token Plan Personal Edition
Reemplace YOUR_API_KEY con su API Key de Token Plan Personal Edition. Los modelos disponibles se enumeran en modelos admitidos.
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default auto
Estos comandos escriben en ~/.hermes/config.yaml. También puede editar el archivo directamente:
Ejemplo de config.yaml
model:
default: auto
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Token Plan Team Edition
Reemplace YOUR_API_KEY con su API Key de Token Plan Team Edition. Los modelos disponibles se enumeran en modelos admitidos.
hermes config set model.provider custom
hermes config set model.base_url https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default auto
Estos comandos escriben en ~/.hermes/config.yaml. También puede editar el archivo directamente:
Ejemplo de config.yaml
model:
default: auto
provider: custom
base_url: https://token-plan.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Plan de codificación
Reemplace YOUR_API_KEY con su API Key de Coding Plan. Los modelos disponibles se enumeran en modelos admitidos.
hermes config set model.provider custom
hermes config set model.base_url https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-plus
Estos comandos escriben en ~/.hermes/config.yaml. También puede editar el archivo directamente:
Ejemplo de config.yaml
model:
default: qwen3.7-plus
provider: custom
base_url: https://coding-intl.dashscope.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Pago por uso
Reemplace YOUR_API_KEY con su Clave API de Alibaba Cloud Model Studio. Los modelos disponibles se enumeran en API compatible con Anthropic. Establezca base_url para su región. La clave API debe coincidir con la región seleccionada y reemplace WorkspaceId con su ID de espacio de trabajo real.
- Norte de China 2 (Beijing):
https://{WorkspaceId}.cn-beijing.maas.aliyuncs.com/apps/anthropic - Singapur:
https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic. - EE. UU. (Virginia):
https://{WorkspaceId}.us-east-1.maas.aliyuncs.com/apps/anthropic.
hermes config set model.provider alibaba
hermes config set model.base_url https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
hermes config set model.api_mode anthropic_messages
hermes config set model.api_key YOUR_API_KEY
hermes config set model.default qwen3.7-max
Estos comandos escriben en ~/.hermes/config.yaml. También puede editar el archivo directamente:
Ejemplo de config.yaml
model:
default: qwen3.7-max
provider: alibaba
base_url: https://{WorkspaceId}.ap-southeast-1.maas.aliyuncs.com/apps/anthropic
api_mode: anthropic_messages
api_key: YOUR_API_KEY
Verificación de la configuración
Envíe un mensaje de prueba para verificar su configuración:
hermes chat -q "Hello"
Una respuesta exitosa confirma que la configuración funciona. Para cambiar de modelo, utilice el parámetro -m:
hermes chat -m qwen3.7-max
FAQ
Códigos de error
Para errores de configuración, consulte las preguntas frecuentes de su plan de facturación:
- Pago por uso: Solución de problemas de códigos de error
- Coding Plan: Preguntas frecuentes sobre Coding Plan
- Token Plan Personal Edition: Preguntas frecuentes de Token Plan Personal Edition
- Token Plan Team Edition: Preguntas frecuentes sobre Token Plan Team Edition