Instalas Hermes en una máquina nueva, o simplemente quieres probarlo antes de comprar una API key en cualquier sitio. La secuencia antigua era: ejecutar hermes setup, registrarte en la consola de algún provider, copiar la key, pegarla — quince minutos de configuración antes de haberle dicho una sola palabra al agente.

Ese paso ahora es opcional. Hermes crea una identidad gratuita de Nous al arrancar, así que puedes hablar con él sobre un modelo por defecto desde el primer momento, e iniciar sesión más tarde cuando de verdad quieras el catálogo completo y las herramientas de pago.

Qué pasa cuando no hay nada configurado

En el primer arranque, Hermes dedica unos segundos a configurar el free tier, que se muestra como «Setting up free inference…». Después:

• la inferencia corre sobre un único modelo llamado nous/welcome;
• el banner y hermes auth status muestran Nous · free tier · nous/welcome;
• hermes model lista una fila Nous · free tier con ese único modelo.

No aparece ningún asistente y nada es obligatorio. hermes setup sigue ahí cuando quieras configurar un provider propio.

Una advertencia: el free tier todavía está en despliegue. Hasta que esté activo para todos, nada de esto ocurre a menos que el proceso se haya iniciado con HERMES_GUEST_ONBOARDING=1 en su entorno — y ojo, la variable solo acepta 1; true no cuenta. Sin ella, una instalación nueva se comporta exactamente como antes: el selector de provider del primer arranque.

Qué te da el free tier y qué no

	Free tier	Tras iniciar sesión
Inferencia	nous/welcome (un solo modelo)	Catálogo completo de modelos de Nous Portal
Connectors (Gmail, Linear, Notion, …)	Sí	Sí
Herramientas de pago (búsqueda web, generación de imágenes, TTS, navegador en la nube)	No	Sí, con cargo a tu suscripción
Créditos o saldo	Ninguno	Sí

Los «connectors» son las cuentas de terceros que vinculas en el portal de Nous para que el agente pueda actuar dentro de ellas. Funcionan en el free tier sin ningún inicio de sesión — y eso explica buena parte de por qué existe el free tier.

El trabajo en segundo plano también corre sobre el mismo modelo: la compactación de conversaciones, los títulos de chat, la comprensión de imágenes y demás tareas de mantenimiento pasan por nous/welcome.

El free tier es el último recurso, nunca una preferencia. Cualquier provider que configures gana:

Tienes	La inferencia corre en	Connectors
Nada	Free tier de Nous (nous/welcome)	Free tier
Una API key en .env (OpenRouter, OpenAI, Anthropic, …)	Tu key	Free tier
model.provider definido en config.yaml	Ese provider	Free tier
Sesión iniciada en Nous Portal	Nous Portal	Tu cuenta

Una instalación que ya tiene un provider igualmente configura el free tier una vez al arrancar, para que los connectors tengan con qué autenticarse; tu provider sigue haciendo la inferencia, y un aviso único te lo indica.

Dos detalles que confunden con facilidad. Si model.default en config.yaml nombra otra cosa mientras el free tier está haciendo la inferencia, Hermes usa nous/welcome de todas formas y lo dice en una línea. Y si pides un modelo que el free tier no puede servir, no cambia en silencio — te indica dónde ir:

gpt-5 needs a Nous account or an API key. Use /login to sign in, or /model to pick another provider.

Llamar a una herramienta de pago muestra This needs a Nous account. Use /login to sign in. dentro de un chat, y nombra hermes auth upgrade en la terminal. El turno en sí continúa sin ella.

Cuándo deberías iniciar sesión

Dondequiera que esté el free tier — incluidas las instalaciones que hacen inferencia con su propia key — hay dos formas de entrar.

Desde un chat. Envía /login en un mensaje directo (Telegram, Discord, Slack y otros; en Slack usa /hermes login, y también funciona en una sesión de chat por CLI). Tiene que ser un mensaje directo emparejado: en cualquier otro sitio Hermes responde Sign in from a direct message with Hermes. Recibes tres mensajes — el enlace de consentimiento, el código de inicio de sesión en su propia línea y luego un aviso de espera que empieza por Do not share this code. Puedes seguir chateando mientras Hermes espera, y el resultado llega al mismo DM. Volver a ejecutar /login reemplaza el código anterior.

Desde una terminal.

hermes auth upgrade

Imprime una URL y un código corto, y abre el navegador a menos que pases --no-browser o estés en una sesión SSH. Después de confirmar en el navegador, la terminal dice Signed in as [email protected]. Si tu modelo por defecto era nous/welcome, una segunda línea nombra el modelo que usa ahora tu cuenta.

La inferencia pasa al catálogo de tu cuenta, se desbloquean las herramientas de pago y hermes auth status deja de mostrar la línea del free tier. Un modelo por defecto que hayas elegido tú no se toca.

Dos cosas que conviene saber de antemano:

1. Una cuenta por instalación. /login vincula toda la instalación a la cuenta que aprueba el código: su inferencia, sus connectors, cada chat que atiende. En un gateway donde varias personas pueden escribir por DM al bot, define allow_admin_from para la plataforma de modo que solo un operador pueda ejecutarlo.
2. hermes auth add nous --type oauth también inicia sesión, pero reemplaza el free tier por completo y no traspasa tus connectors. Usa /login, o hermes auth upgrade, cuando tengas connectors que quieras conservar.

Los cuatro sitios donde el desktop lo muestra

La app de desktop corre sobre el mismo free tier, visible en cuatro sitios:

Dónde	Qué ves
Primer arranque	Una pantalla de listo: «Hermes is ready.» con el modelo por defecto nous/welcome, un badge de Free tier y Begin; debajo están «Sign in with a Nous account instead» y «Other providers». Se muestra una sola vez.
Primer arranque con tu propia API key ya presente	Una franja única encima del composer: «Free Nous inference and connectors are now available.» con un selector de modelo, inicio de sesión y descartar
Barra de estado	Un chip Nous · free tier · nous/welcome con un badge de Sign in, ocultable desde el menú contextual de la barra
Settings › Billing	«You’re on the Nous free tier» con un único botón de inicio de sesión; el resumen muestra Plan «Free tier», Model nous/welcome, Connectors «Included» — sin saldo y nada que pagar

La CLI y el desktop leen el mismo estado local, así que los avisos únicos se comparten: ver uno en la CLI significa que no lo volverás a ver en el desktop para esa identidad, y al contrario.

Cómo desactivarlo

hermes config set nous.guest false

nous.guest es un ajuste normal de config.yaml (por defecto true), no una variable de entorno. Con él desactivado: no hay inferencia gratuita, no hay connectors sin inicio de sesión, no hay fila de free tier en hermes model, y a una instalación nueva se le ofrece hermes setup en su lugar. Una cuenta de Nous con sesión iniciada, tus propias API keys y cualquier otro provider funcionan exactamente como antes.

Una nota de privacidad que merece ser explícita: el free tier necesita una identidad para la autenticación y el rate limiting, así que la primera vez que hace falta, Hermes crea una identidad anónima en el portal de Nous y guarda la credencial en tu directorio de Hermes, compartida entre los profiles que hay debajo. No contiene dirección de correo, ni nombre, ni ningún otro dato personal, y caduca a los 14 días sin uso — Hermes crea una nueva de forma transparente. Iniciar sesión traslada tus connectors vinculados a tu cuenta; poner nous.guest en false significa que no se crea ni se usa ninguna identidad.

Qué significan los errores

Síntoma	Qué significa	Qué hacer
El primer comando dice It looks like Hermes isn't configured yet y ofrece hermes setup	El free tier no se pudo configurar en unos segundos: sin conexión, no disponible en el portal o limitado por rate limiting	Vuelve a estar online y reintenta, o ejecuta hermes setup y añade un provider. Nada queda a medio configurar
Nous free tier is not open on this portal.	El portal al que apunta Hermes no ofrece el free tier (por ejemplo, después de definir HERMES_PORTAL_BASE_URL)	Inicia sesión con una cuenta, quita el override o añade tu propia key
Nous free tier is rate limited; try again shortly.	El portal está limitando la creación de nuevos free tiers	Espera unos minutos o añade tu propia key
This needs a Nous account.	Llamaste a una herramienta de pago estando en el free tier	/login en un chat, hermes auth upgrade en una terminal, o configura esa herramienta con tu propia key en hermes tools
El selector solo muestra nous/welcome bajo Nous	Es lo esperado en el free tier	Inicia sesión para tener el catálogo completo, o añade la key de otro provider
El free tier dejó de funcionar tras dos semanas sin usarlo	La identidad anónima caducó y se reemplaza en el siguiente arranque	Nada — simplemente vuelve a arrancar Hermes. Los connectors vinculados antes del paréntesis hay que volver a vincularlos salvo que hubieras iniciado sesión

La versión corta

El free tier sabe lo que es: una forma de arrancar, no un plan a largo plazo. Para quien prueba Hermes por primera vez, elimina todos los pasos entre instalar y tener una conversación funcional. Para quien ya tiene un provider, resuelve en silencio la autenticación de connectors. Y cuando necesitas el catálogo más grande o herramientas conectadas a la web, un inicio de sesión de un minuto retoma donde lo dejó.

Para empezar desde cero, consulta la guía de instalación. Toda la superficie de comandos para cuentas está en la referencia de hermes auth, el cambio de modelo y provider está en hermes model, y los cambios recientes de plataforma y modelos están en las notas de versión.