Tutorial 11: Rodando o Hermes no Android (Termux)

Bem-vindos de volta, exploradores do Hermes! Neste tutorial, vamos colocar o Hermes Agent para funcionar no seu celular Android usando o Termux. Sim, você leu certo — seu dispositivo de bolso agora pode se tornar um hub completo de assistente de IA. E a melhor parte? O processo de instalação ficou muito mais simples.

O Que Você Vai Precisar

Antes de mergulharmos, vamos garantir que seu ambiente Termux esteja pronto. O único pré-requisito real é o Git. Se você ainda não o instalou, abra o Termux e execute:

pkg install git curl xz-utils

Só isso! Você não precisa instalar manualmente Python, Node.js, ripgrep ou ffmpeg — o instalador do Hermes cuida de tudo isso automaticamente. Ele detecta o que está faltando e configura tudo para você.

Instalação em Uma Linha

Aqui está o comando mágico. Abra o Termux e execute:

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

Sim, é realmente assim tão simples. O instalador cuida de tudo:

uv (gerenciador de pacotes Python rápido)
Python 3.11 (via uv, sem precisar de sudo)
Node.js v22 (para automação de navegador e ponte com WhatsApp)
ripgrep (busca rápida de arquivos)
ffmpeg (conversão de formato de áudio para TTS)

Ele também clona o repositório, configura um ambiente virtual, cria o comando global hermes e configura seu provedor de LLM. Ao final, você já está pronto para conversar.

Onde as Coisas São Instaladas

No Android/Termux, você instala como usuário normal, então a estrutura fica assim:

O Quê	Onde
Código	`~/.hermes/hermes-agent/`
Binário `hermes`	`~/.local/bin/hermes` (link simbólico)
Diretório de dados	`~/.hermes/`

Sua configuração pessoal (auth, habilidades, sessões) fica em ~/.hermes/, então tudo permanece organizado no seu diretório home.

Comece a Conversar

Quando o instalador terminar, recarregue seu shell e inicie o Hermes:

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

Pronto — você já está falando com o Hermes direto do seu dispositivo Android!

Configurando Seu Ambiente

Após a instalação, você pode querer ajustar algumas coisas. Aqui estão os 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

Se você quer a configuração mais rápida possível, use a opção Portal. Uma única assinatura cobre mais de 300 modelos, além do Tool Gateway (busca na web, geração de imagens, TTS, navegador na nuvem). Chega de ficar gerenciando chaves de API para cada ferramenta:

hermes setup --portal

Este único comando faz login, define Nous como seu provedor e ativa o Tool Gateway. Pronto.

Migrando de Outra Máquina?

Já está rodando o Hermes no seu computador? Você não precisa reconstruir tudo do zero. Traga um único agente com:

hermes profile import

Ou restaure um backup completo com hermes import. Só lembre: uma exportação de perfil exclui credenciais por design, então use hermes backup para um backup completo.

Uma Nota Sobre o Modo Root

Se você algum dia instalar o Hermes como root (usando sudo curl ... | sudo bash), a estrutura muda para um layout FHS (/usr/local/lib/hermes-agent/ e /usr/local/bin/hermes). Isso é útil para máquinas compartilhadas onde uma única instalação no sistema atende a todos. Mas para o Termux, a instalação por usuário é perfeita.

Concluindo

É só isso! Agora você tem um Hermes Agent totalmente funcional rodando no seu dispositivo Android. Seja no ônibus, numa reunião ou apenas relaxando no sofá, seu assistente de IA está sempre no seu bolso.

No próximo tutorial, vamos explorar como usar o Hermes com plataformas de mensagens como WhatsApp e Telegram. Até lá, boas conversas!