Tutorial 12: Configuración de Nix y NixOS

¡Bienvenido de nuevo a nuestra serie de tutoriales sobre Hermes Agent! En esta entrada, vamos a guiarte en la instalación de Hermes Agent en sistemas Nix y NixOS. Pero hay un detalle: la documentación oficial ha cambiado y Nix ya no es una ruta de instalación oficialmente compatible. ¡No te preocupes! Aún tienes opciones, y cubriremos todo lo que necesitas saber.

¿Qué ha cambiado?

El equipo de Hermes ha simplificado significativamente la instalación. En lugar de mantener múltiples rutas de instalación, ahora recomiendan el instalador universal para todos, incluidos los usuarios de Nix. El soporte para Nix ahora es “solo con el mejor esfuerzo”, lo que significa que puede funcionar, pero no está probado ni garantizado oficialmente.

La ruta recomendada: Instalador universal

Para la mayoría de los usuarios, la forma más fácil de poner en marcha Hermes Agent es con el instalador de una sola línea. Funciona en Linux, macOS, WSL2 e incluso Android (Termux):

curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

En Windows nativo, usa PowerShell en su lugar:

iex (irm https://hermes-agent.nousresearch.com/install.ps1)

El instalador se encarga de todo automáticamente: Python, Node.js, ripgrep, ffmpeg, la clonación del repositorio, el entorno virtual y el comando global hermes. Al final, estarás listo para chatear.

¿Y la configuración específica para Nix?

Si ya usas Nix (en NixOS, macOS o Linux), todavía existe una ruta de configuración dedicada con un flake de Nix, un módulo declarativo para NixOS y un modo de contenedor opcional. Consulta la guía de configuración de Nix y NixOS en la documentación oficial para más detalles.

Pero nuestro consejo es este: prueba primero el instalador universal. Es la ruta oficialmente compatible y está diseñado para “simplemente funcionar”.

Requisitos previos: Mantenlo simple

Antes de ejecutar el instalador, asegúrate de tener:

Git (obligatorio en todas las plataformas que no sean Windows)
curl y xz-utils en Linux (el instalador descarga Node.js como un archivo .tar.xz)
g++ o build-essential en Debian/Ubuntu (solo si planeas usar la aplicación de escritorio)

¡Eso es todo! No necesitas instalar Python, Node.js, ripgrep ni ffmpeg manualmente. El instalador detecta lo que falta y lo instala por ti.

En Debian/Ubuntu, puedes dejar todo listo con:

sudo apt install curl xz-utils build-essential

Después de la instalación

Cuando el instalador termine, recarga tu shell y empieza a chatear:

source ~/.bashrc   # o: source ~/.zshrc
hermes             # ¡Empieza a chatear!

Configurando tu entorno

Después de la instalación, puedes ajustar los detalles con comandos dedicados:

hermes model          # Elige tu proveedor de LLM y modelo
hermes tools          # Configura qué herramientas están habilitadas
hermes gateway setup  # Configura plataformas de mensajería
hermes config set     # Establece valores de configuración individuales
hermes config get     # Inspecciona valores de configuración individuales
hermes setup          # O ejecuta el asistente de configuración completo

La ruta más rápida: Nous Portal

Aquí tienes un consejo de experto: si quieres evitar el lío de gestionar claves por herramienta, usa Nous Portal. Una sola suscripción cubre más de 300 modelos más el Tool Gateway (búsqueda web, generación de imágenes, TTS, navegador en la nube). Empieza con un solo comando:

hermes setup --portal

Eso te inicia sesión, establece Nous como tu proveedor y activa el Tool Gateway, todo a la vez.

¿Te mudas desde otra máquina?

Si ya estás usando Hermes en otra máquina, no necesitas reconstruir todo desde cero. Restaura una copia de seguridad completa con hermes import, o transfiere un solo agente con hermes profile import. Solo recuerda: una exportación de perfil excluye las credenciales por diseño, así que no es una copia de seguridad completa. Usa hermes backup para eso.

Reflexiones finales

Aunque Nix ya no es una ruta de instalación oficialmente compatible, el instalador universal hace que la configuración sea más fácil que nunca. Para la mayoría de los usuarios, es el camino a seguir, incluso en NixOS. Si encuentras problemas, la guía específica para Nix sigue ahí como respaldo.

En la próxima entrega de nuestra serie, nos sumergiremos en la configuración de tu primer agente. ¡Hasta entonces, feliz chat!