Skip to content

FlashHead

Support Status

Item Value
Model ID flashhead
Backend direct_ws
Evidence level Documented
Best for Existing standalone FlashHead WebSocket service

Owned by the FlashHead service. OpenTalking only connects to its HTTP/WebSocket endpoints.

Weights

OpenTalking does not manage FlashHead weights. Search:

Directory Layout

The FlashHead service owns its weight directory. OpenTalking only needs avatar manifests and service URLs.

Configuration

.env
OPENTALKING_FLASHHEAD_WS_URL=ws://<flashhead-host>:8766/v1/avatar/realtime
OPENTALKING_FLASHHEAD_BASE_URL=http://<flashhead-host>:8766
OPENTALKING_FLASHHEAD_MODEL=soulx-flashhead-1.3b
configs/default.yaml
models:
  flashhead:
    backend: direct_ws

Start

Start the FlashHead service first, then OpenTalking:

Terminal
bash scripts/quickstart/start_all.sh

/models Verification

Terminal
curl -s http://127.0.0.1:8000/models | python3 -m json.tool

After configuring the WebSocket URL, expected:

{"id":"flashhead","backend":"direct_ws","connected":true,"reason":"direct_ws"}

Common Errors

Symptom Action
reason=not_configured Set OPENTALKING_FLASHHEAD_WS_URL.
WebSocket handshake fails Check FlashHead service path, port, and cross-host network.
Avatar mismatch Use an avatar with model_type: flashhead.

Frontend Entry

After the model or backend service is running, use the OpenTalking WebUI:

Terminal
cd "$OPENTALKING_HOME"
bash scripts/quickstart/start_frontend.sh --api-port 8000 --web-port 5173 --host 0.0.0.0

For a remote server, forward your local browser port to the server 5173, then open http://127.0.0.1:5173.