Troubleshooting

This guide covers common issues you might encounter when using Django Polly and how to resolve them.

Installation Issues

Issue: ImportError when trying to use Django Polly

Solution:

  1. Ensure Django Polly is installed: pip install django-polly

  2. Check that ‘django_polly’ is in INSTALLED_APPS in your Django settings.

  3. Run python manage.py migrate to apply any pending migrations.

LLM Integration Problems

Issue: LLM model not loading

Solution:

  1. Verify that you’ve downloaded the LLM model using the download_model management command.

  2. Check that the AI_MODELS_PATH in your settings.py points to the correct directory.

  3. Ensure you have sufficient disk space and memory to load the model.

Issue: Slow response times from LLM

Solution:

  1. Consider using a smaller or more efficient LLM model.

  2. Increase the resources (CPU/RAM) available to your application.

  3. Implement caching for common queries to reduce load on the LLM.

WebSocket Connection Issues

Issue: WebSocket connection fails

Solution:

  1. Ensure that Daphne is installed and configured correctly.

  2. Check that ASGI_APPLICATION is set correctly in your settings.py.

  3. Verify that your CHANNEL_LAYERS configuration is correct.

Issue: Real-time updates not working

Solution:

  1. Check your browser console for JavaScript errors.

  2. Ensure that your frontend code is correctly connecting to the WebSocket.

  3. Verify that your consumer is properly configured to send updates.

Database Issues

Issue: Database migrations failing

Solution:

  1. Ensure you’re running the latest version of Django Polly.

  2. Try running python manage.py makemigrations django_polly before migrating.

  3. Check the database logs for any specific error messages.

General Troubleshooting Tips

  1. Check the Django Polly logs for any error messages or warnings.

  2. Ensure all dependencies are up to date.

  3. Verify that your Django and Python versions are compatible with Django Polly.

  4. If all else fails, try creating a new virtual environment and reinstalling Django Polly and its dependencies.

If you’re still experiencing issues after trying these solutions, please open an issue on the Django Polly GitHub repository with a detailed description of your problem and the steps you’ve taken to resolve it.