Photon — Puente de iMessage para macOS

Imagina tener un asistente personal que pueda responderte por iMessage — pero en lugar de un humano, es tu agente de IA. Eso es exactamente lo que Photon hace por Hermes Agent. Piénsalo como un traductor amigable que se sienta entre tu Mac y tu iPhone, asegurándose de que ambos puedan conversar sin que necesites ejecutar un servidor complicado o abrir puertos.

¿Qué es realmente Photon?

Photon es un servicio gestionado que conecta Hermes con iMessage. No necesitas tener un relay de Mac ni lidiar con las estrictas reglas de mensajería de Apple. Photon se encarga de las partes complicadas — como la asignación de números de teléfono y la prevención de spam — para que puedas concentrarte en construir tu agente.

¿La mejor parte? Es gratis para empezar. Photon usa un grupo compartido de números iMessage para su nivel gratuito. Eso significa que la persona que le envía mensajes a tu agente podría ver diferentes números de remitente, pero cada conversación se mantiene estable. Si necesitas un número dedicado para negocios, hay un nivel de pago — pero la opción gratuita es perfecta para experimentar.

Cómo funciona (sin la sobrecarga técnica)

Photon usa una conexión persistente, muy parecida a Discord o Slack. Sin webhooks, sin URLs públicas, sin secretos de firma que gestionar. En su lugar:

• Hermes ejecuta un pequeño sidecar de Node.js (un programa auxiliar) que se comunica con Photon.
• El sidecar escucha los iMessages entrantes y se los pasa a tu agente.
• Tu agente responde, y el sidecar envía la respuesta de vuelta a través de Photon.

Es como tener un recepcionista que recibe cartas, te las entrega y luego envía tus respuestas por correo — todo automáticamente.

Lo que necesitas antes de empezar

• Una cuenta de Photon (regístrate en app.photon.codes)
• Node.js 18.17 o superior (verifica con node --version)
• Un número de teléfono que pueda recibir iMessage (para vincular tu cuenta)

Eso es todo. Sin URL pública, sin túnel, sin configuración de router.

Configuración inicial (toma menos de 5 minutos)

La forma más fácil es usar el asistente guiado:

hermes gateway setup

Luego elige Photon iMessage de la lista.

O, si prefieres la ruta directa, ejecuta este comando de una línea (reemplaza el número de teléfono con el tuyo):

hermes photon setup --phone +15551234567

Esto es lo que sucede detrás de escena:

1. Un inicio de sesión de dispositivo abre una página en tu navegador para que la apruebes.
2. Hermes encuentra o crea un proyecto en tu cuenta de Photon.
3. Habilita Spectrum (la capa de mensajería de Photon) y rota el secreto de tu proyecto.
4. Tu número de teléfono se registra como usuario de Spectrum.
5. Verás tu línea iMessage asignada — ese es el número al que la gente envía mensajes para contactar a tu agente.
6. Las dependencias del sidecar se instalan automáticamente.

Si estás ejecutando en un contenedor Docker o en un sistema de archivos de solo lectura, no te preocupes — el sidecar automáticamente usa una carpeta escribible en ~/.hermes/photon/sidecar. También puedes establecer una ubicación personalizada con PHOTON_SIDECAR_DIR.

Tus credenciales se guardan de forma segura en ~/.hermes/.env, igual que con cualquier otro canal que Hermes soporta.

Resumen y un consejo práctico

Photon hace que la integración con iMessage sea genuinamente simple. Sin mantenimiento de servidores, sin IP pública, sin dolores de cabeza con Apple. Obtienes un puente funcional en minutos, y el nivel gratuito es suficiente para empezar a construir.

Consejo práctico: Antes de enviar tu primer mensaje de prueba, asegúrate de que tu número de teléfono sea correcto y pueda recibir iMessage. Usa el mismo número con el que te registraste — de lo contrario, podrías preguntarte por qué tu agente no responde. Y si alguna vez te quedas atascado, simplemente vuelve a ejecutar el comando de configuración; está diseñado para ser seguro de repetir.

Ahora adelante — dale a tu agente un número de teléfono y ¡deja que comiencen los mensajes! 📱🤖

---