Tutorial prático · Pedro Gadelha

Prepare seu Hermes.

Um checklist direto para contratar a VPS correta, preparar suas contas, instalar o Hermes e entregar o Kit Inicial ao agente. Siga a ordem e marque cada item concluído.

01

Contrate uma VPS limpa

Escolha um servidor sem painel ou aplicativos pré-instalados. Isso deixa o ambiente pronto para receber somente o Hermes e evita conflitos.

HostGator VPS NVMe 4

Na contratação, selecione SO simples com Ubuntu 22.04 LTS. Não adicione cPanel, n8n, OpenClaw ou GatorClaw.

Ver oferta da VPS ↗

Observação: o botão acima usa um link de indicação. A oferta exibida e as condições comerciais são definidas pela HostGator no momento da contratação.

02

Prepare Telegram e ChatGPT

Você precisa somente destas duas contas. O Telegram deve estar instalado no celular e também no computador que será usado durante a configuração.

Conta do Telegram

Crie sua conta usando seu número de telefone. Depois instale o aplicativo no celular e no computador e entre com a mesma conta nos dois dispositivos.

Baixar o Telegram ↗
Conta ChatGPT

Para configurar o provedor OpenAI Codex pelo login, deixe ativa uma conta ChatGPT com plano Plus ou Pro compatível.

Ver planos do ChatGPT ↗

Use a mesma conta do Telegram no celular e no computador. Não compartilhe códigos temporários de login ou a senha root da VPS.

03

Guarde os dados da VPS

Quando o servidor ficar pronto, a HostGator informará o endereço IP, a porta SSH e o acesso administrativo. Preencha a ficha abaixo durante a instalação.

Use exatamente a porta informada pela hospedagem. Se nenhuma porta diferente foi indicada, mantenha 22.

Comando para acessar a VPS
ssh -p 22 root@SEU_IP

🔒 Guarde a senha definitiva em um gerenciador de senhas. Este formulário não salva IP, porta, usuário ou senha quando a página é fechada.

04

Instale e conecte o Hermes

Agora você vai entrar na VPS e iniciar a instalação guiada do Hermes. O instalador conduz as configurações seguintes, incluindo a inteligência e o Telegram. O primeiro comando é montado automaticamente com os dados preenchidos no item 3.

Comando sincronizado: não é necessário digitar novamente o IP, a porta ou o usuário. Se o comando não aparecer pronto abaixo, volte ao item 3 e preencha os dados da VPS ↑.

1 · Comando gerado com os dados do item 3
Preencha o IP no item 3 para gerar o comando de acesso.

Primeiro acesso: este comando usa o IP, a porta e o usuário preenchidos no item 3. Se aparecer uma pergunta com yes/no, digite yes e pressione Enter. Depois informe a senha root. O terminal não mostra caracteres enquanto você digita ou cola a senha — isso é normal.

2 · Preparar a VPS e instalar o Hermes
sudo apt update && \
sudo apt install -y git curl xz-utils && \
curl -fsSL https://hermes-agent.nousresearch.com/install.sh | bash

Pode colar o bloco inteiro de uma vez. O instalador oficial prepara as dependências e pode abrir o assistente de configuração no próprio terminal. Leia cada pergunta antes de confirmar.

3 · Atualizar o terminal e verificar
source ~/.bashrc
hermes doctor

Siga o assistente na tela: o instalador continuará fazendo as perguntas necessárias para configurar a inteligência, o Telegram e o funcionamento do agente. Leia cada opção antes de confirmar.

Se algo der errado · Ver o registro
journalctl --user -u hermes-gateway -n 80 --no-pager

Referência: estes comandos seguem a documentação oficial de instalação do Hermes ↗.

05

Instale o Codex no terminal

O Codex será seu apoio técnico dentro da própria VPS. Se o Hermes apresentar algum erro, você poderá abrir o Codex no terminal para analisar arquivos, executar verificações e ajudar a resolver o problema.

1 · Instalar o Codex na VPS
curl -fsSL https://chatgpt.com/codex/install.sh | sh

Cole o comando no terminal da VPS e pressione Enter. Ele usa o instalador oficial do Codex para Linux.

2 · Abrir o Codex
codex

No primeiro acesso: escolha Sign in with ChatGPT e siga o endereço ou código mostrado no terminal. Entre com a mesma conta ChatGPT Plus ou Pro preparada no item 2.

Conferir a instalação
codex --version

Segurança: não cole senhas, tokens do Telegram ou outras credenciais no chat. Leia os comandos e as aprovações mostrados pelo Codex antes de permitir alterações na VPS. Ver documentação oficial do Codex CLI ↗

06

Envie o Kit Inicial ao agente

Quando seu agente Hermes já estiver disponível no Telegram, envie o arquivo ZIP diretamente na conversa. Você não precisa abrir nem extrair o conteúdo.

Kit Inicial do Hermes — Pedro Gadelha

Baixe o arquivo ZIP no computador. Depois abra a conversa com seu agente no Telegram e envie o arquivo inteiro como documento.

Baixar o Kit Inicial em ZIP ↓
Mensagem para enviar junto com o arquivo
Este é o meu Kit Inicial do Hermes. Pode abrir o arquivo, ler primeiro o documento 0-LEIA-PRIMEIRO-AGENTE.md e me guiar na configuração passo a passo?

Importante: envie o ZIP inteiro. O próprio agente abre o arquivo, lê as instruções e começa a fazer as perguntas da configuração.

Copiado!