descomplicai

guia de montagem

Cria o teu MYLO.

Seis passos: um sítio onde ele viva, a tua subscrição de ChatGPT lá dentro, e o Telegram para lhe falares — por escrito ou por voz.

Começar pelo passo 1
MYLO, um cogumelo de aguarela com chapéu vermelho e lenço verde, a acenar de cima de uma pedra com flores.

o que vais montar

MYLO é um nome. O motor chama-se Hermes.

“MYLO” é o nome que o Jaime deu ao seu assistente. Por baixo corre o Hermes, um agente de código aberto da Nous Research que qualquer pessoa instala na sua máquina. Quem monta o seu escolhe o nome que quiser.

Não precisas de chave de API nem de comprar créditos: o Hermes entra com a subscrição de ChatGPT que já tens. Depois falas com ele no Telegram — por escrito ou por notas de voz, como falarias com um contacto.

Não é preciso ser programador. É preciso copiar meia dúzia de comandos com calma, uma vez. A maior parte do tempo é à espera de descarregamentos.

  • corre na tua máquina
  • entra com a tua subscrição
  • fala contigo no Telegram

Os comandos aqui são os da versão de hoje. Se alguma coisa mudar, quem manda é a documentação oficial: documentação do Hermes

antes de começares

Quatro coisas na mão.

a jornada

Seis passos, de cima a baixo.

Os blocos escuros são para copiar tal e qual. Cada passo traz uma ilustração do que vais ver no ecrã.

  1. Um sítio onde ele viva

    O mais simples é o computador que já tens. Instalas, entras na tua conta, está. O limite é honesto: enquanto a máquina estiver desligada, ou com a sessão fechada, o teu assistente não responde a ninguém.

    Uma VPS — um computador alugado, sempre acordado — resolve isso, mas traz SSH, Linux, cópias de segurança e uma conta ao fim do mês. Começa pelo teu computador. Mudas depois, se o “sempre ligado” te fizer mesmo falta.

    Desenho: um computador de secretária aceso, com um pequeno servidor ao lado como passo seguinte.
    ilustração · o teu computador chega para começar; a VPS é o passo seguinte, não o primeiro

  2. Instala o Hermes

    O Hermes é código aberto, da Nous Research. Há duas vias e só precisas de uma: descarregar a aplicação no site oficial, que trata de tudo sozinha, ou colar uma linha no terminal.

    Windows

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

    macOS · Linux

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

    Não é preciso ser administrador. O instalador traz o que falta — uv, Python, Node.js, ffmpeg — e, se não tiveres Git, uma cópia dele. Demora uns minutos.

    Quando acabar, abre um terminal NOVO (o atalho só aparece em janelas novas) e escreve hermes. Se faltar alguma coisa, hermes doctor diz-te o quê.

    Site oficial e aplicação

    a instalar

    • uv
    • Python
    • Node.js
    • ripgrep
    • ffmpeg
    • Git
    ilustração · o que o instalador traz contigo, para não teres de o ir buscar

  3. Liga a tua subscrição de ChatGPT

    Sem chave de API e sem faturação à parte: o Hermes abre uma sessão própria com a tua conta.

    no terminal 
    hermes model

    Na lista de fornecedores escolhe “ChatGPT or Codex Subscription”. O terminal responde com um endereço e um código de oito caracteres: abres o endereço no browser, entras na tua conta como sempre e escreves lá o código. Tens quinze minutos antes de ele expirar.

    No fim vês “Login successful!” e a lista de modelos da tua conta — escolhes um. Essa lista muda com o tempo, por isso não há aqui nenhum nome fixo.

    Confirma antes de seguir. Escreve hermes, pede-lhe que se apresente em duas frases e vê se responde. Se não responder, pára aqui: tudo o que vem a seguir assenta em cima disto.

    Tens Grok em vez de ChatGPT? O caminho é hermes auth add xai-oauth, e pede SuperGrok ou X Premium+. Há contas a que a xAI recusa este acesso — se acontecer, não é culpa tua.

    a entrar na conta

    To continue, follow these steps:

  1. Open this URL in your browser:
     https://auth.openai.com/codex/device

  2. Enter this code:
     XXXX-XXXX

Waiting for sign-in...
    ilustração · é este ecrã que aparece; o terminal fala inglês e o código é sempre diferente

  4. Cria o bot no Telegram

    O teu assistente precisa de uma boca no Telegram. Quem a cria é o @BotFather, o bot oficial do Telegram — fala inglês e responde na hora.

    no Telegram, ao @BotFather 
    /newbot

    Ele pede-te duas coisas: um nome visível (o que quiseres) e um nome de utilizador único, que tem de acabar em “bot”. No fim devolve-te um token — uma linha com números, dois pontos e um monte de letras.

    O token é uma palavra-passe: quem o tiver manda no bot. Não o publiques nem o mandes a ninguém. Se escapar, envia /revoke ao BotFather e fazes outro.

    Falta o teu número. Manda uma mensagem ao @userinfobot e ele responde com o teu id — um número só teu. Não é o teu @nome: é este número que decide quem pode falar com o bot.

    ilustração · o token verdadeiro nunca se mostra a ninguém, nem numa página como esta

  5. Liga o Telegram ao Hermes

    Agora apresentas um ao outro. Um assistente guia-te: escolhes Telegram, colas o token e escreves o teu id na lista de quem pode falar com ele.

    no terminal 
    hermes gateway setup

    Por omissão, o Hermes recusa toda a gente até essa lista existir. Não é um defeito: é a definição segura, e é bom que fique assim.

    Depois é arrancá-lo e mandar a primeira mensagem ao teu bot.

    no terminal 
    hermes gateway

    Para não teres de deixar uma janela aberta, hermes gateway install deixa-o a arrancar sozinho quando inicias sessão, e hermes gateway status diz-te como está.

    Nunca ligues a opção que deixa falar toda a gente. Isto não é um bot público: é um bot com acesso ao teu computador.

    a ligar o Telegram

    ? Platform: Telegram
? Bot token: ••••••••••••••••••

The gateway DENIES all users
by default for security.

? Allowed user IDs
  (comma-separated): 123456789

Saved — only these users can
interact with the bot.
    ilustração · a lista de ids é a fechadura da porta; sem ela, ninguém entra

  6. Fala com ele. E manda-lhe voz.

    Abre a conversa com o teu bot e diz-lhe quem és, como queres ser tratado e no que andas a trabalhar. Depois carrega no microfone e manda-lhe uma nota de voz a pensar alto: ele transcreve e responde ao que ouviu.

    O passo que parte o português: o Hermes vem configurado para ouvir inglês. Uma linha resolve isto, e é das primeiras coisas a fazer.

    no terminal, uma vez 
    hermes config set stt.language pt

    A transcrição pode correr no teu próprio computador, de graça e sem chave nenhuma: na primeira nota de voz ele descarrega o modelo sozinho. Para português vale a pena pedir-lhe um bocadinho maior do que o que vem de origem.

    opcional, melhor ouvido 
    hermes config set stt.local.model small

    Dentro da conversa: /new começa do zero, /model troca de modelo, /sethome escolhe este chat para receber o que ele te mandar por iniciativa dele, e /help mostra o resto.

    As melhores ideias do Jaime não nascem à secretária, nascem a passear sozinho. Abre o Telegram a meio da caminhada, grava uma nota de voz a pensar alto e manda-a ao seu assistente. Mais tarde, às vezes horas depois, está lá o áudio arrumado em pontos. Nenhuma ideia se perde só porque ele estava a andar sem papel nem teclado por perto.

    ilustração · ele devolve a transcrição para veres o que ouviu, e só depois responde

e depois?

Quando o básico estiver a andar.

o que é justo saberes

Notas honestas.

Encalhaste num passo?

Pergunta ao MYLO aqui mesmo, ou escreve-me e montamos isto juntos.

Documentação do Hermes Pede-me ajuda