README.md

metadata

title: CodexMobile Relay
sdk: docker
app_port: 7860

CodexMobile Relay

This HuggingFace Docker Space runs the CodexMobile relay entrypoint.

Configure Space variables:

CODEXMOBILE_MODE=relay
HOST=0.0.0.0
PORT=7860
CODEXMOBILE_RELAY_REQUEST_TIMEOUT_MS=120000
CODEXMOBILE_RELAY_HEARTBEAT_MS=15000
CODEXMOBILE_RELAY_IDLE_HEARTBEAT_MS=300000
CODEXMOBILE_RELAY_PENDING_REQUESTS_MAX=64
CODEXMOBILE_RELAY_BROWSER_PENDING_REQUESTS_MAX=6
CODEXMOBILE_RELAY_TOKEN_REQUESTS_PER_MINUTE=120
CODEXMOBILE_RELAY_TOKEN_REQUEST_WINDOW_MS=60000

Mac connector defaults to an unauthenticated HTTP keepalive against /api/status?keepalive=1 every 240000 ms. Active intervals below 60000 ms are ignored. Set CODEXMOBILE_RELAY_KEEPALIVE_MS=0 on the connector only when you explicitly want to disable that Space wakeup traffic.

Configure Space secrets:

CODEXMOBILE_RELAY_SECRET=<at-least-32-character-random-secret>
CODEXMOBILE_RELAY_PREVIOUS_SECRET=<optional-previous-secret-during-rotation>

Do not commit relay secrets, browser tokens, pairing codes, logs, or local state.