Browse documentation

Troubleshooting & Diagnostics

Common Issues & Resolutions

1. Gemini Live Rate Limit (429)

  • Symptom: Zaya shows "Quota cooling down".
  • Fix: Right-click Zaya > Gemini API keys... and add multiple comma-separated keys for automatic rotation.

2. Microphone Not Detected

  • Symptom: Speech turns do not trigger.
  • Fix: Open Settings & Controls > Audio Devices and verify that your default recording device is selected.

3. Hand Tracking Performance

  • Symptom: Jittery hand landmarks.
  • Fix: Ensure adequate room lighting and run powershell tools\setup_hands.ps1 to verify MediaPipe weights.

Something unclear or not working?

Troubleshooting guide ↗Report a problem ↗