Sua Primeira Conversa com IA em 5 Minutos

Bem-vindo de volta à nossa série de tutoriais do Hermes Agent! No Tutorial 1, preparamos você com o básico. Agora, vamos fazer você conversar com uma IA — de verdade, em cerca de cinco minutos.

Se você já instalou uma ferramenta e pensou: “Ok, está aqui… e agora?”, este tutorial é para você. Vamos percorrer o caminho mais rápido do zero até uma conversa funcional com IA, e vou mostrar exatamente o que fazer se algo der errado.

A Regra de Ouro

Antes de mergulharmos, aqui vai o conselho que vai te poupar horas de frustração:

Se o Hermes não consegue completar um chat normal, não adicione mais recursos ainda.

Faça uma conversa limpa funcionar primeiro. Só então, e somente então, comece a adicionar recursos sofisticados como gateways, skills ou voz. Confie em mim.

Passo 1: Instale o Hermes Agent

Se você ainda não instalou o Hermes, a maneira mais fácil é baixar o instalador Hermes Desktop do site oficial. Ele funciona no macOS e Windows e configura tanto os apps de linha de comando quanto os de desktop.

Prefere a linha de comando? Execute isto no seu terminal:

Linux / macOS / WSL2 / Android (Termux):

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

Windows (PowerShell):

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

Depois que terminar, recarregue seu shell:

source ~/.bashrc   # ou source ~/.zshrc

Passo 2: Escolha Seu Provedor (A Grande Decisão)

Este é o passo de configuração mais importante. Execute este comando:

hermes model

Isso te guia pela escolha de um provedor de forma interativa. Aqui está a cola:

Provedor	O que é	Como configurar
Nous Portal	Assinatura, zero configuração	Login OAuth, sem necessidade de chaves de API
OpenAI Codex	Assinatura ChatGPT/Codex	Autenticação por código de dispositivo
Anthropic	Modelos Claude	OAuth (plano Max) ou chave de API
OpenRouter	Muitos modelos, uma chave	Insira sua chave de API
Fireworks AI	API compatível com OpenAI	Defina `FIREWORKS_API_KEY`
Z.AI	Modelos GLM	Defina `GLM_API_KEY`
Kimi / Moonshot	Modelos Moonshot	Defina `KIMI_API_KEY`

Dica para iniciantes: Se você quer o caminho mais fácil possível, use o Nous Portal. Uma assinatura cobre mais de 300 modelos, e você pode configurar tudo com um único comando:

hermes setup --portal

Isso faz login, define a Nous como seu provedor e ativa o Tool Gateway (busca na web, geração de imagens e muito mais) de uma vez só.

Passo 3: Escolha Seu Modo de Configuração

Quando você executar hermes setup em uma instalação nova, verá três opções:

Quick Setup (Nous Portal) — Login OAuth gratuito, sem chaves de API. O caminho rápido recomendado.
Full Setup — Configure cada provedor e ferramenta manualmente (traga suas próprias chaves).
Blank Slate — Tudo começa desligado, exceto o mínimo necessário (provedor, modelo, operações de arquivo, terminal). Perfeito se você quer um agente mínimo e totalmente controlado.

Para este tutorial, escolha Quick Setup se você quer conversar em minutos. Escolha Blank Slate se você é do tipo que gosta de construir tudo do zero.

Passo 4: Tenha Sua Primeira Conversa

Assim que seu provedor estiver configurado, é só começar a conversar:

hermes

É isso. Você deve ver um prompt. Digite algo como “Olá! O que você pode fazer?” e veja a mágica acontecer.

E Se Algo Der Errado?

Aqui está o fluxo de solução de problemas:

Não consegue instalar? Consulte o guia de instalação para pré-requisitos.
O chat não responde? Execute hermes model novamente e verifique se seu provedor está configurado corretamente.
Usando um endpoint personalizado? Verifique novamente a URL do endpoint, o nome do modelo e o comprimento do contexto.
No celular? Consulte o guia Termux dedicado para dicas específicas do Android.

Prefere Assistir?

A equipe do Onchain AI Garage fez um ótimo vídeo passo a passo de instalação, configuração e comandos básicos. Confira a playlist Hermes Agent Tutorials & Use Cases no YouTube.

O Que Vem Depois?

No próximo tutorial, vamos cobrir como adicionar mais ferramentas, configurar um gateway para bots e fazer o Hermes trabalhar para você 24 horas por dia, 7 dias por semana. Mas por enquanto — vá ter uma conversa. Você merece.