django-autocomplete-light

What it is and what it does

django-autocomplete-light is a Django form widget library that replaces standard choice and model choice fields with autocomplete-enabled alternatives. It lets users type to filter options rather than scrolling through static lists, improving UX for forms with many choices. The package supports both a native web component (dal_alight) and select2.js, and handles Django's multiple choice fields, model relationships, and generic foreign keys.

The library is designed for developers building Django applications who need to add search-as-you-type functionality to forms without heavy client-side configuration. It integrates directly into Django's form system, supports dynamic widget creation for inline forms, and includes a test API for custom autocomplete logic. The single runtime dependency (django) keeps installation friction low.

Use it for:

• Replace a large dropdown of database records with a searchable autocomplete field in a Django admin or custom form.
• Build multi-step forms where available choices in one field depend on selections in another field.
• Add autocomplete to inline formsets that are created dynamically without page reload.
• Implement custom autocomplete logic with your own queryset filtering and choice creation rules.
• Migrate from plain select fields to select2.js-powered autocompletes with minimal code changes.

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

Provides autocomplete widgets for Django forms that integrate with Django's choice and model choice fields, supporting both native web components and select2.js.

Yes. The package is actively maintained, has no known vulnerabilities, carries a permissive MIT license, and solves a common Django UX problem with low install friction. It is well-established (in production since 2012) and supports current Python and Django versions. Install it if you need autocomplete widgets in Django forms.

Install

django-autocomplete-light on PyPI

pip install django-autocomplete-light

uv add django-autocomplete-light

poetry add django-autocomplete-light

Installing django-autocomplete-light

Before you install

Low friction install with a single runtime dependency on django. Actively maintained with a recent release (57 days ago) and 1870 repository stars; supports current Python versions (3.11–3.14) and modern Django (5.2–6.0+).

License in practice

MIT license (permissive) places no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install django-autocomplete-light

from django_autocomplete_light.widgets import ModelSelect2

# In your form class:
class MyForm(forms.Form):
    my_field = forms.ModelChoiceField(
        queryset=MyModel.objects.all(),
        widget=ModelSelect2(url='my_autocomplete_url')
    )

Requires Django 5.2 or 6.0+ and Python 3.11 or later; autocomplete endpoint must be configured in your Django URL routing.

Verify before relying

• Whether django-querysetsequence is automatically installed for generic foreign key support or must be added separately.
• Performance characteristics when handling large querysets or high-frequency autocomplete requests.
• Specifics of how custom scripts integrate with dynamic widget creation in inlines.

Package facts

Evidence: django_autocomplete_light-5.0.0-py3-none-any.whl

Keywords: django, autocomplete

Tags

More Python Modules packages