Troubleshooting

​

Connection Errors

​

WebSocket connection failed

• Verify your apiKey is correct.
• Check if your firewall or proxy allows connections over port 443.
• If using a custom serverUrl, ensure it is correct and the server is reachable.

​

Audio Issues

​

AI voice is choppy or distorted

• This is often caused by network jitter or high latency. Ensure you have a stable internet connection.
• JavaScript: Check your buffer window. The server expects audio in 20ms chunks.
• Node.js: Ensure your Speaker settings match the AUDIO_CONFIG (44.1kHz, 16-bit, mono).

​

No audio playback (Node.js)

• Ensure your Speaker settings match the AUDIO_CONFIG.
• Check if another application is using the audio device exclusively.
• Verify that your system has the correct audio drivers (ALSA/PulseAudio for Linux).

​

Microphone not capturing audio

• Ensure you have granted the necessary permissions to the application.
• Check if the correct input device is selected in your system settings.

​

Python Specific Issues

​

ImportError: No module named 'lokutor'

• Ensure you have installed the package via pip install lokutor.
• If using a virtual environment, make sure it is activated.