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.ps1to verify MediaPipe weights.