Local WebSocket

The Desktop app exposes one authenticated WebSocket for third-party integrations. REST and Vision access stay on the same computer. Users may explicitly enable avatar-only LAN access for renderers and physical avatars on the same network.

Key facts:

  • Loopback URL: ws://127.0.0.1:51743 (override with INTEGRATION_WS_PORT)
  • LAN discovery: _ailicia-avatar._tcp.local when the user enables Avatar LAN access
  • Transport: JSON control and event messages, with optional binary avatar audio chunks
  • Authorization: explicit user consent with scope-specific revocation
  • LAN boundary: only avatar.events.read and avatar protocol messages are accepted from non-loopback clients

Quick links: