Photon — Jembatan iMessage untuk macOS

Bayangkan memiliki asisten pribadi yang bisa membalas pesanmu lewat iMessage — tapi alih-alih manusia, itu adalah agen AI-mu. Persis itulah yang dilakukan Photon untuk Hermes Agent. Anggap saja seperti penerjemah ramah yang duduk di antara Mac dan iPhone-mu, memastikan keduanya bisa mengobrol tanpa kamu perlu menjalankan server yang rumit atau membuka port apa pun.

Apa Sebenarnya Photon Itu?

Photon adalah layanan terkelola yang menghubungkan Hermes ke iMessage. Kamu tidak perlu memiliki relay Mac sendiri atau berurusan dengan aturan perpesanan ketat dari Apple. Photon menangani bagian-bagian rumit — seperti alokasi nomor telepon dan pencegahan spam — sehingga kamu bisa fokus membangun agenmu.

Bagian terbaiknya? Gratis untuk memulai. Photon menggunakan kumpulan nomor iMessage bersama untuk tingkat gratisnya. Artinya, orang yang mengirim pesan ke agenmu mungkin melihat nomor pengirim yang berbeda, tetapi setiap percakapan tetap stabil. Jika kamu butuh nomor khusus untuk bisnis, ada tingkat berbayar — tetapi opsi gratis sudah sempurna untuk bereksperimen.

Cara Kerjanya (Tanpa Beban Teknis)

Photon menggunakan koneksi persisten, mirip seperti Discord atau Slack. Tanpa webhook, tanpa URL publik, tanpa kelola signing secret. Sebagai gantinya:

• Hermes menjalankan sidecar Node.js kecil (program pembantu) yang berkomunikasi dengan Photon.
• Sidecar mendengarkan iMessage masuk dan meneruskannya ke agenmu.
• Agenmu membalas, dan sidecar mengirim balasan tersebut kembali melalui Photon.

Ini seperti memiliki petugas ruang surat yang menerima surat, menyerahkannya kepadamu, lalu mengirimkan balasanmu — semuanya otomatis.

Yang Kamu Butuhkan Sebelum Memulai

• Akun Photon (daftar di app.photon.codes)
• Node.js 18.17 atau lebih baru (periksa dengan node --version)
• Nomor telepon yang bisa menerima iMessage (untuk mengikat akunmu)

Itu saja. Tanpa URL publik, tanpa tunnel, tanpa konfigurasi router.

Pengaturan Pertama Kali (Kurang dari 5 Menit)

Cara termudah adalah menggunakan wizard berpandu:

hermes gateway setup

Lalu pilih Photon iMessage dari daftar.

Atau, jika kamu lebih suka jalur langsung, jalankan perintah satu baris ini (ganti nomor telepon dengan milikmu):

hermes photon setup --phone +15551234567

Inilah yang terjadi di balik layar:

1. Login perangkat membuka halaman browser untuk kamu setujui.
2. Hermes menemukan atau membuat proyek di akun Photon-mu.
3. Ini mengaktifkan Spectrum (lapisan perpesanan Photon) dan memutar ulang secret proyekmu.
4. Nomor teleponmu terdaftar sebagai pengguna Spectrum.
5. Kamu akan melihat jalur iMessage yang ditetapkan — itulah nomor yang dihubungi orang untuk menjangkau agenmu.
6. Dependensi sidecar terinstal secara otomatis.

Jika kamu menjalankan dalam kontainer Docker atau sistem file read-only, jangan khawatir — sidecar otomatis beralih ke folder yang dapat ditulis di bawah ~/.hermes/photon/sidecar. Kamu juga bisa mengatur lokasi khusus dengan PHOTON_SIDECAR_DIR.

Kredensialmu disimpan dengan aman di ~/.hermes/.env, sama seperti saluran lain yang didukung Hermes.

Ringkasan dan Tip Praktis

Photon membuat integrasi iMessage menjadi sangat sederhana. Tanpa pemeliharaan server, tanpa IP publik, tanpa pusing urusan Apple. Kamu mendapatkan bridge yang berfungsi dalam hitungan menit, dan tingkat gratisnya sudah cukup untuk mulai membangun.

Tip praktis: Sebelum mengirim pesan uji pertamamu, pastikan nomor teleponmu benar dan benar-benar bisa menerima iMessage. Gunakan nomor yang sama dengan yang kamu daftarkan — jika tidak, kamu mungkin bingung mengapa agenmu tidak membalas. Dan jika kamu pernah mengalami kebuntuan, jalankan saja ulang perintah pengaturannya; perintah itu dirancang aman untuk diulang.

Sekarang silakan — beri agenmu nomor telepon dan biarkan perpesanan dimulai! 📱🤖

---