Tutorial 12: Configuração do Nix e NixOS

Bem-vindo de volta à nossa série de tutoriais sobre o Hermes Agent! Neste post, vamos mostrar como instalar o Hermes Agent em sistemas Nix e NixOS. Mas aqui está o detalhe — a documentação oficial mudou, e o Nix não é mais um caminho de instalação oficialmente suportado. Não se preocupe, porém! Você ainda tem opções, e vamos cobrir tudo o que você precisa saber.

O Que Mudou?

A equipe do Hermes simplificou significativamente a instalação. Em vez de manter vários caminhos de instalação, eles agora recomendam o instalador universal para todos — incluindo usuários de Nix. O suporte ao Nix agora é “apenas melhor esforço”, ou seja, pode funcionar, mas não é oficialmente testado ou garantido.

O Caminho Recomendado: Instalador Universal

Para a maioria dos usuários, a maneira mais fácil de colocar o Hermes Agent em funcionamento é com o instalador de uma linha. Ele funciona no Linux, macOS, WSL2 e até no Android (Termux):

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

No Windows nativo, use o PowerShell:

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

O instalador cuida de tudo automaticamente — Python, Node.js, ripgrep, ffmpeg, o clone do repositório, o ambiente virtual e o comando global hermes. Ao final, você já está pronto para conversar.

E a Configuração Específica do Nix?

Se você já usa Nix (no NixOS, macOS ou Linux), ainda existe um caminho de configuração dedicado com um flake Nix, módulo declarativo NixOS e modo de contêiner opcional. Consulte o guia de Configuração do Nix e NixOS na documentação oficial para mais detalhes.

Mas aqui vai nosso conselho: experimente o instalador universal primeiro. É o caminho oficialmente suportado e foi projetado para “simplesmente funcionar”.

Pré-requisitos: Mantenha Simples

Antes de executar o instalador, certifique-se de ter:

Git (obrigatório em todas as plataformas que não sejam Windows)
curl e xz-utils no Linux (o instalador baixa o Node.js como um arquivo .tar.xz)
g++ ou build-essential no Debian/Ubuntu (apenas se você planeja usar o aplicativo de desktop)

É isso! Você não precisa instalar Python, Node.js, ripgrep ou ffmpeg manualmente. O instalador detecta o que está faltando e instala para você.

No Debian/Ubuntu, você pode deixar tudo pronto com:

sudo apt install curl xz-utils build-essential

Após a Instalação

Quando o instalador terminar, recarregue seu shell e comece a conversar:

source ~/.bashrc   # ou: source ~/.zshrc
hermes             # Comece a conversar!

Configurando Sua Instalação

Após a instalação, você pode ajustar as coisas com comandos dedicados:

hermes model          # Escolha seu provedor de LLM e modelo
hermes tools          # Configure quais ferramentas estão habilitadas
hermes gateway setup  # Configure plataformas de mensagens
hermes config set     # Defina valores de configuração individuais
hermes config get     # Inspecione valores de configuração individuais
hermes setup          # Ou execute o assistente de configuração completo

Caminho Mais Rápido: Nous Portal

Aqui vai uma dica de profissional: se você quiser pular a gestão de chaves por ferramenta, use o Nous Portal. Uma única assinatura cobre mais de 300 modelos, além do Tool Gateway (busca na web, geração de imagens, TTS, navegador em nuvem). Comece com um único comando:

hermes setup --portal

Isso faz login, define a Nous como seu provedor e ativa o Tool Gateway — tudo de uma vez.

Migrando de Outra Máquina?

Se você já está usando o Hermes em outra máquina, não precisa reconstruir tudo do zero. Restaure um backup completo com hermes import, ou traga um agente individual com hermes profile import. Lembre-se: uma exportação de perfil exclui credenciais por design, então não é um backup completo. Use hermes backup para isso.

Considerações Finais

Embora o Nix não seja mais um caminho de instalação oficialmente suportado, o instalador universal torna a configuração mais fácil do que nunca. Para a maioria dos usuários, é o caminho a seguir — até no NixOS. Se você encontrar problemas, o guia específico do Nix ainda está disponível como alternativa.

No próximo post da nossa série, vamos mergulhar na configuração do seu primeiro agente. Até lá, boas conversas!