Photon — Ponte iMessage para macOS

Imagine ter um assistente pessoal que responde suas mensagens no iMessage — mas, em vez de um humano, é o seu agente de IA. É exatamente isso que o Photon faz pelo Hermes Agent. Pense nele como um tradutor amigável entre o seu Mac e o seu iPhone, garantindo que os dois conversem sem você precisar rodar um servidor complicado ou abrir portas.

O Que É o Photon, Na Real?

O Photon é um serviço gerenciado que conecta o Hermes ao iMessage. Você não precisa ter um Mac como relay nem lidar com as regras rígidas de mensageria da Apple. O Photon cuida das partes complicadas — como alocação de números de telefone e prevenção de spam — para que você possa focar em construir seu agente.

A melhor parte? É grátis para começar. O Photon usa um pool compartilhado de números iMessage no plano gratuito. Isso significa que a pessoa que envia mensagem para o seu agente pode ver números de remetente diferentes, mas cada conversa permanece estável. Se você precisar de um número dedicado para negócios, existe um plano pago — mas a opção gratuita é perfeita para experimentar.

Como Funciona (Sem Excesso de Tecnologia)

O Photon usa uma conexão persistente, bem parecida com a do Discord ou Slack. Sem webhooks, sem URLs públicas, sem segredos de assinatura para gerenciar. Em vez disso:

• O Hermes roda um pequeno sidecar em Node.js (um programa auxiliar) que conversa com o Photon.
• O sidecar escuta mensagens iMessage recebidas e as repassa para o seu agente.
• Seu agente responde, e o sidecar envia a resposta de volta pelo Photon.

É como ter um funcionário da sala de correspondência que recebe as cartas, entrega para você e depois envia suas respostas — tudo automaticamente.

O Que Você Precisa Antes de Começar

• Uma conta no Photon (cadastre-se em app.photon.codes)
• Node.js 18.17 ou mais recente (verifique com node --version)
• Um número de telefone que possa receber iMessage (para vincular sua conta)

Só isso. Sem URL pública, sem túnel, sem configuração de roteador.

Configuração Inicial (Leva Menos de 5 Minutos)

O jeito mais fácil é usar o assistente guiado:

hermes gateway setup

Depois escolha Photon iMessage na lista.

Ou, se preferir o caminho direto, rode este comando de uma linha (substitua o número de telefone pelo seu):

hermes photon setup --phone +15551234567

Veja o que acontece nos bastidores:

1. Um login de dispositivo abre uma página no navegador para você aprovar.
2. O Hermes encontra ou cria um projeto na sua conta do Photon.
3. Ele ativa o Spectrum (a camada de mensageria do Photon) e rotaciona o segredo do seu projeto.
4. Seu número de telefone é registrado como usuário do Spectrum.
5. Você verá sua linha iMessage atribuída — é o número para o qual as pessoas enviam mensagem para falar com seu agente.
6. As dependências do sidecar são instaladas automaticamente.

Se você estiver rodando em um contêiner Docker ou em um sistema de arquivos somente leitura, não se preocupe — o sidecar automaticamente usa uma pasta gravável em ~/.hermes/photon/sidecar. Você também pode definir um local personalizado com PHOTON_SIDECAR_DIR.

Suas credenciais são salvas com segurança em ~/.hermes/.env, assim como em todos os outros canais que o Hermes suporta.

Resumo e uma Dica Prática

O Photon torna a integração com iMessage genuinamente simples. Sem manutenção de servidor, sem IP público, sem dores de cabeça com a Apple. Você tem uma ponte funcionando em minutos, e o plano gratuito já é suficiente para começar a construir.

Dica prática: Antes de enviar sua primeira mensagem de teste, confirme se seu número de telefone está correto e se realmente consegue receber iMessage. Use o mesmo número com o qual você se registrou — caso contrário, você pode ficar se perguntando por que seu agente não está respondendo. E se você travar em algum momento, é só rodar o comando de configuração novamente; ele foi feito para ser seguro de repetir.

Agora vá em frente — dê um número de telefone ao seu agente e deixe as mensagens rolarem! 📱🤖