Como instalar e configurar o Hermes Agent em um VPS Linux

Por que hospedar o Hermes Agent em um VPS remoto?

Como o Hermes Agent é capaz de executar tarefas em segundo plano, agendar tarefas e responder a chamadas de webhooks, precisamos de uma máquina que esteja em standby 24 horas por dia, 7 dias por semana. Computadores locais podem sofrer quedas de energia, desconectar-se da Internet ou ter seus recursos de hardware esgotados. Um servidor remoto garante 99% de tempo de atividade (uptime) e facilita a escala de recursos computacionais sempre que necessário.

Existem vários provedores acessíveis de servidores privados virtuais (VPS) no mercado, como Hetzner, Hostinger e Contabo. Nós usamos a Contabo há algum tempo e, até o momento, tudo tem funcionado muito bem.

Como configurar o Hermes Agent em um VPS Linux

Passo 1: Conectar-se ao seu VPS

Abra o terminal e conecte-se via SSH à sua máquina remota:

ssh root@your_server_ip

Certifique-se de que os pacotes do seu servidor estejam atualizados:

sudo apt update && sudo apt upgrade -y

Adicione um novo usuário, hermes, ou o seu nome de usuário de preferência:

sudo adduser hermes 
sudo passwd hermes

Desative o login por senha para o usuário root:

1. Abra o arquivo de configuração do SSH:

sudo nano /etc/ssh/sshd_config

2. Localize a linha PermitRootLogin e altere seu valor para no:

PermitRootLogin no

3. Salve o arquivo e reinicie o serviço SSH:

sudo systemctl restart ssh

Passo 2: Instalar o Hermes Agent

Execute o seguinte comando:

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

Depois de instalado, verifique a instalação digitando:

hermes --version

Execute hermes setup para configurar o Hermes Agent:

Selecione um provedor de LLM, comece com o DeepSeek e adicione outros mais tarde.

Insira a chave de API do DeepSeek: Selecione local machine para executar o Hermes Agent: Selecione Telegram nos canais de comunicação. Outros canais podem ser configurados posteriormente.

Passo 3: Integração com o Telegram

Selecione [2] para usar o bot do Telegram.

Acesse o Telegram e pesquise por 'BotFather'.

Clique em Open para abrir o 'BotFather'.

Clique em Create a New Bot (ou envie o comando /newbot).

Preencha os nomes requeridos e crie o bot.

Clique em Copy para copiar o token e cole-o de volta no terminal.

Encontre o ID da sua conta de usuário do Telegram e adicione-o à lista de usuários permitidos ('Allowed user list'):

• Pesquise por '@raw_data_bot' no Telegram.
• Clique no RawDataBot e depois no botão Start (Começar). O ID do usuário será exibido após P.S. Your ID:.
• Copie o ID de usuário e cole-o no terminal.

Como estamos executando na nuvem, queremos que o serviço seja iniciado automaticamente. Deixe todas as opções como padrão:

Testando seu Hermes Agent com o bot do Telegram

Execute o seguinte comando para iniciar o hermes gateway:

hermes gateway

Acesse o Telegram e adicione o bot criado, '@tech_cloud_hermes_bot', às suas conversas.

• Digite '/new' no Telegram para iniciar uma nova sessão do Hermes Agent.
• Digitar /commands listará todos os comandos disponíveis.
• Digitar /model exibirá uma lista com os LLMs disponíveis.

Executando o Hermes Gateway como um serviço em segundo plano

Crie o arquivo de serviço:

sudo nano /etc/systemd/system/hermes-gateway.service

Cole o seguinte conteúdo, substituindo hermes em '/home/hermes' pelo seu nome de usuário preferido:

[Unit]
Description=Hermes Gateway
After=network.target

[Service]
User=hermes
WorkingDirectory=/home/hermes
ExecStart=/home/hermes/.local/bin/hermes gateway
Restart=always
RestartSec=10
Environment=PATH=/home/hermes/.local/bin:/usr/local/bin:/usr/bin:/bin

[Install]
WantedBy=multi-user.target

Habilite e inicie o serviço:

sudo systemctl daemon-reload
sudo systemctl enable hermes-gateway
sudo systemctl start hermes-gateway
sudo systemctl status hermes-gateway

Conclusão

Neste artigo, focamos em como configurar o Hermes Agent e usar o Telegram para se comunicar com ele. Manter o Hermes Agent em execução em um servidor remoto oferece um assistente digital real que funciona 24 horas por dia, 7 dias por semana.