Skip to main content

Troubleshooting

http://<internal-runtime-redacted>:18180/healthz does not answer​

Run:

.\scripts\start-local-audio-runtime.ps1 -ForceRestart -WaitForReady
.\scripts\get-runtime-status.ps1

Then inspect:

  • %LOCALAPPDATA%\JHF-Tenter\local-audio-runtime\runtime.stdout.log
  • %LOCALAPPDATA%\JHF-Tenter\local-audio-runtime\runtime.stderr.log

Likely owner:

  • JaddaHelpifyr/jhf-tenter

Tray shows Audio missing​

The tray is the owner, but the local audio server may still be cold or failed.

Actions:

  1. refresh the tray
  2. run .\scripts\start-local-audio-runtime.ps1
  3. confirm get-runtime-status.ps1 reports installed=true

Likely owner:

  • JaddaHelpifyr/jhf-tenter

Tray shows Audio warming​

This means the local Voxtral STT model is still loading.

Wait for the next refresh cycle and verify:

.\scripts\get-runtime-status.ps1

Tray shows Audio degraded​

Current expected degraded cases include:

  • STT is live but TTS is not yet self-hosted on this host
  • the server surfaces are alive but a required model path is not fully available

This is not the expected label for a guardrail-denied cold start. If startup-state.json shows a denied helper/tray start because of host or vmmemWSL pressure, the tray status should read Audio cold, not Audio degraded.

Read back:

  • GET /healthz
  • GET /models
  • GET /metrics/latency

Escalation path:

  • local audio runtime and voice toolkit drift -> JaddaHelpifyr/jhf-tenter
  • deployment/runtime materialization drift on Host172 -> owning deployment/runtime repo after tenter evidence exists

Repo-Owned Docs / Contract Check​

Run this bounded repo-owned check first:

python3 scripts/validate_docs_platform_v1_6.py
python3 scripts/export-fabric-metadata.py --check
python3 scripts/docs/validate_docs_inventory.py

If those checks are green and the remaining problem is still live-runtime-only, continue with the deeper runtime verifiers documented in OPERATIONS.md.

Legacy Boundary​

This runbook no longer documents Ollama as the active Windows voice path.

Historical Ollama / local Mistral notes belong to legacy maintenance context only.

AGPLv3. See ../LICENSE (LICENSE). Learn more at helpifyr.com.