Mac Relay

~/.pearl/projects/aquaping/
  client.py            — local copy (Forgejo repo main branch)
  relay/
    server.py          — TCP/JSON → BlueBubbles bridge

Config: ~/.config/aquaping/config.json

{
  "bb_url": "http://localhost:1234",
  "bb_password": "...",
  "minimax_api_key": "...",
  "image_descriptions_consent": true,
  "image_descriptions_daily_limit": 100
}

Pi front-door config may point at a remote BlueBubbles Mac:

{
  "bb_url": "http://100.93.138.108:1234",
  "bb_password": "...",
  "bb_backends": [
    {"name": "mac10", "bb_url": "http://100.93.138.108:1234"}
  ]
}

The relay bind address is controlled by environment: - AQUAPING_BIND_HOST - AQUAPING_BIND_PORT

The RG client accepts an ordered relay list:

AQUAPING_RELAYS="100.120.38.37:9876,100.93.138.108:9876"

Legacy AQUAPING_RELAY and AQUAPING_PORT still work for a single relay.

minimax_api_key is a runtime secret. Do not commit it, print it, or copy it into the FROM House feed. Shared non-secret guidance lives in this repo and Pearl Brain; the raw value stays in the relay host config or its secret source.