Contents

Stream setup

Avatar and OBS

The bridge can serve the built avatar and its speech feed from the address configured in avatar.listen; OBS uses that address as a Browser Source.

Browser Source

In OBS, add a Browser Source at http://localhost:8432/. The bridge serves the built avatar from avatar.static_dir and exposes its speech feed on the same avatar listener.

Remote access

The Docker kit binds the avatar and dashboard ports to loopback. From another machine, use an SSH tunnel or put an HTTPS reverse proxy in front of the service; keep the local listener private.

Health and metrics

/healthz reports status and the bridge version on the avatar and dashboard listeners. GET /metrics exposes counters; requests from outside loopback need METERING_ADMIN_TOKEN as a Bearer token. GET /metrics?dump=1 includes the related log, voice, and memory-fact counts.