Photon — мост iMessage для macOS | Easy Understand Hermes Agent

Представьте себе личного помощника, который может написать вам в iMessage — но вместо человека это ваш ИИ-агент. Именно это Photon и делает для Hermes Agent. Думайте о нём как о дружелюбном переводчике, который сидит между вашим Mac и iPhone и следит за тем, чтобы они могли общаться без необходимости поднимать сложный сервер или открывать порты.

Что такое Photon на самом деле?

Photon — это управляемый сервис, который соединяет Hermes с iMessage. Вам не нужен собственный Mac-релей или борьба со строгими правилами Apple. Photon берёт на себя все сложности — например, выделение номеров и защиту от спама — так что вы можете сосредоточиться на создании своего агента.

Самое приятное? Начать можно бесплатно. Photon использует общий пул номеров iMessage для бесплатного тарифа. Это значит, что человек, пишущий вашему агенту, может видеть разные номера отправителей, но каждая переписка остаётся стабильной. Если вам нужен выделенный номер для бизнеса, есть платный тариф — но бесплатного варианта более чем достаточно для экспериментов.

Как это работает (без технических сложностей)

Photon использует постоянное соединение, как Discord или Slack. Никаких вебхуков, публичных URL или секретов для подписи. Вместо этого:

Hermes запускает небольшой Node.js сайдкар (вспомогательную программу), который общается с Photon.
Сайдкар слушает входящие iMessage и передаёт их вашему агенту.
Ваш агент отвечает, а сайдкар отправляет ответ обратно через Photon.

Это как иметь клерка в приёмной, который получает письма, передаёт их вам, а затем отправляет ваши ответы — всё автоматически.

Что нужно перед началом

Аккаунт Photon (регистрация на app.photon.codes)
Node.js 18.17 или новее (проверьте командой node --version)
Номер телефона, который может принимать iMessage (для привязки аккаунта)

Вот и всё. Никаких публичных URL, туннелей или настройки роутера.

Первоначальная настройка (занимает меньше 5 минут)

Самый простой способ — использовать мастер:

hermes gateway setup

Затем выберите Photon iMessage из списка.

Или, если предпочитаете прямой путь, выполните эту команду (замените номер телефона на свой):

hermes photon setup --phone +15551234567

Вот что происходит за кулисами:

Вход на устройстве открывает страницу в браузере для подтверждения.
Hermes находит или создаёт проект в вашем аккаунте Photon.
Включается Spectrum (мессенджер-слой Photon) и меняется секрет проекта.
Ваш номер телефона регистрируется как пользователь Spectrum.
Вы увидите выделенную линию iMessage — это номер, на который люди пишут, чтобы связаться с вашим агентом.
Зависимости сайдкара устанавливаются автоматически.

Если вы работаете в Docker-контейнере или в файловой системе только для чтения, не волнуйтесь — сайдкар автоматически переключится на записываемую папку в ~/.hermes/photon/sidecar. Также можно указать своё расположение с помощью PHOTON_SIDECAR_DIR.

Ваши учётные данные сохраняются в ~/.hermes/.env, как и для любого другого канала, поддерживаемого Hermes.

Итоги и практический совет

Photon делает интеграцию с iMessage по-настоящему простой. Никакого обслуживания сервера, публичного IP или головной боли с Apple. Вы получаете работающий мост за считанные минуты, а бесплатного тарифа достаточно, чтобы начать создавать.

Практический совет: перед отправкой первого тестового сообщения убедитесь, что ваш номер телефона указан правильно и действительно может принимать iMessage. Используйте тот же номер, с которым вы регистрировались — иначе вы будете гадать, почему агент не отвечает. А если что-то пошло не так, просто запустите команду настройки заново; она безопасна для повторного использования.

Так что вперёд — дайте вашему агенту номер телефона и пусть начнётся переписка! 📱🤖