Skip to content

Edge Relay Quick Start (Mac mini)

Last Verified: February 2026
Canonical implementation: ../archety-edge

This is the quickest path to get the Mac mini edge relay talking to this backend.

1) Backend (Railway) variables

Set: 

EDGE_SECRET=<generated_hex>
ENVIRONMENT=production

Generate: 

openssl rand -hex 32

2) Edge relay (Mac mini) config

In ../archety-edge: - Copy ../archety-edge/.env.example → .env - Set: 

EDGE_SECRET=<same_generated_hex>
- Point config.yaml at the backend: 
backend:
  url: "https://api.ikiro.ai"

3) Verify end-to-end

  • Incoming iMessage appears in edge logs
  • Edge calls POST /edge/message
  • Backend returns reflex_message/burst_messages or reply_bubbles
  • Edge sends bubbles via iMessage

Optional: enable WebSocket for realtime commands

The backend supports GET /edge/ws?edge_agent_id=... for command push (reflex-first, events). See: - docs/architecture/WEBSOCKET_PROTOCOL.md - docs/architecture/EDGE_CLIENT_WEBSOCKET_INSTRUCTIONS.md