BlueBubbles — IA no iMessage | Easy Understand Hermes Agent

Imagine seu grupo de chat favorito, mas em vez de só seus amigos, tem um assistente super inteligente que pode pesquisar coisas, escrever rascunhos e ajudar você a planejar—tudo sem sair do app de Mensagens. É exatamente isso que o Hermes Agent pode fazer pelo iMessage, e o BlueBubbles é a ponte que torna isso possível.

O que é o BlueBubbles?

O BlueBubbles é um servidor gratuito e de código aberto que roda no seu Mac. Ele se conecta ao app Mensagens desse Mac e expõe uma forma de outros dispositivos (e o Hermes) enviarem e receberem iMessages. Pense nele como um tradutor amigável: seu Mac fala iMessage, o Hermes fala HTTP, e o BlueBubbles traduz entre os dois.

O que você vai precisar

Antes de começar, garanta que você tem:

Um Mac que fica sempre ligado (mesmo enquanto você dorme)
Seu Apple ID conectado ao Mensagens nesse Mac
BlueBubbles Server v1.0.0 ou mais novo instalado (em bluebubbles.app)
Sua instalação do Hermes pronta para usar

Passo 1: Instale o BlueBubbles Server

Baixe e instale o BlueBubbles em bluebubbles.app. Durante a configuração, você vai entrar com seu Apple ID e escolher um método de conexão. Para iniciantes, rede local é o mais fácil—só significa que o Hermes e seu Mac estão no mesmo Wi-Fi.

Passo 2: Pegue a URL do servidor e a senha

Abra o BlueBubbles Server → Configurações → API. Você vai ver duas coisas importantes:

URL do servidor – parece com http://192.168.1.10:1234
Senha do servidor – uma chave secreta que você vai precisar depois

Guarde essas informações—você vai precisar delas no próximo passo.

Passo 3: Conecte o Hermes ao BlueBubbles

O jeito mais fácil é usar o assistente de configuração. Abra seu terminal e rode:

hermes gateway setup

Escolha BlueBubbles (iMessage) e cole a URL do servidor e a senha.

Prefere editar arquivos? Abra o ~/.hermes/.env e adicione:

BLUEBUBBLES_SERVER_URL=http://192.168.1.10:1234
BLUEBUBBLES_PASSWORD=sua-senha-do-servidor

Passo 4: Decida quem pode falar com sua IA

Você não quer estranhos usando sua IA. O Hermes te dá duas opções:

Opção A – Pareamento (recomendado para iniciantes):
Quando alguém te manda mensagem, o Hermes envia um código para a pessoa. Você aprova com:

hermes pairing approve bluebubbles <CODIGO>

Opção B – Pré-aprovar pessoas específicas:
Adicione o e-mail do iMessage ou número de telefone delas no seu arquivo .env:

BLUEBUBBLES_ALLOWED_USERS=usuario@icloud.com,+15551234567

Passo 5: Inicie o gateway

Agora a parte divertida. Rode:

hermes gateway run

O Hermes vai conectar ao BlueBubbles, registrar um webhook (um sistema de notificação em tempo real) e começar a escutar. Sem polling, sem atrasos—só mágica instantânea do iMessage.

Como funciona (em termos simples)

Quando alguém te manda mensagem: iMessage → servidor BlueBubbles → webhook → Hermes (entrega instantânea)
Quando o Hermes responde: Hermes → API REST do BlueBubbles → app Mensagens → iPhone do seu amigo
Mídia também funciona: imagens, notas de voz, vídeos e documentos fluem nos dois sentidos automaticamente

Uma dica rápida para grupos

Por padrão, o Hermes responde a toda mensagem em um grupo. Isso pode ficar barulhento. Para fazer ele responder só quando alguém te mencionar (tipo @Hermes ou @amos), adicione isso na configuração do Hermes:

platforms:
  bluebubbles:
    extra:
      require_mention: true

Mensagens diretas continuam funcionando normalmente—só os grupos viram opt-in.

Concluindo

Agora você tem um assistente de IA pessoal dentro do iMessage. Ele pode responder perguntas, ajudar a escrever mensagens ou rodar automações—tudo do seu app de chat favorito.

Dica prática: comece com um ou dois usuários aprovados (tipo você e um amigo próximo). Teste com pedidos simples primeiro, depois expanda. E lembre-se: seu Mac precisa ficar acordado e conectado para o BlueBubbles funcionar—então deixe ele na tomada e deixe a mágica fluir.