---
id: algoliasearch-django
version: "4.0.0"
license: MIT License
license_treatment: permissive
maintenance: dormant
---

# algoliasearch-django — Algolia Search integration for Django

License: permissive · Maintenance: dormant · Downloads: 904.6K/mo

## What it is and what it does

algoliasearch-django bridges Django models and Algolia's cloud search service, automatically keeping your indexed data in sync as models change. It handles model registration, field mapping, geo-location indexing, and tag-based filtering through a decorator-based configuration system. The package provides management commands for reindexing, applying index settings, and clearing indices, plus a backend search method for server-side queries.

The integration is designed to work with Django 4.x and 5.x on Python 3.8+. You define which model fields to index, customize the index name and object ID, preprocess fields before indexing, and configure Algolia's search parameters. The package handles the mechanics of pushing data to Algolia and retrieving results, leaving the search UI typically to Algolia's InstantSearch.js library.

Use it for:

- Index Django model instances automatically and keep them synchronized with Algolia's cloud index as records are created, updated, or deleted.
- Build a geo-location search feature by mapping model location fields to latitude/longitude coordinates indexed in Algolia.
- Implement faceted search and custom ranking by configuring searchable attributes, custom ranking rules, and tag filters on indexed models.
- Reindex large model datasets or apply index setting changes across your application using the provided management commands.
- Search from your Django backend using raw_search() to retrieve Algolia results directly, or delegate search to the frontend via InstantSearch.js.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Integrates Algolia's hosted search service into Django projects, automatically indexing model data and providing search, geo-search, and tagging capabilities.

Yes, if you are committed to using Algolia as your search backend and need Django integration. The package is stable, has no known vulnerabilities, and low install friction. However, the dormant maintenance status (585 days since last release) means you should verify that it meets your current Django and Algolia API version requirements before adopting it for new projects.

## Install

pip install algoliasearch-django
uv add algoliasearch-django
poetry add algoliasearch-django

## Installing algoliasearch-django

Before you install: Low install friction with a single runtime dependency on django. Maintenance is dormant—last release was 585 days ago on 2025-01-06—but the repository remains active with no archived status, suggesting stability rather than abandonment.

License in practice: MIT License permits commercial and private use with minimal restrictions, making it suitable for most Django projects without licensing concerns.

Quickstart:

pip install algoliasearch-django

# In Django settings:
ALGOLIA = {
    'APPLICATION_ID': 'MyAppID',
    'API_KEY': 'MyApiKey'
}

# In index.py:
import algoliasearch_django as algoliasearch
from .models import YourModel
algoliasearch.register(YourModel)

Requires Algolia account credentials (APPLICATION_ID and API_KEY) configured in Django settings before indexing will function.

Verify before relying:

- Whether AUTO_INDEXING's synchronization overhead is acceptable for large model datasets or high-write-frequency applications.
- Performance characteristics when indexing models with many related objects or complex field preprocessing.
- Current compatibility with the latest Algolia API features beyond what the 4.0.0 release supports.

## Package facts

- License: MIT License (permissive)
- Python support: unspecified
- Install friction: low
- Maintenance: dormant
- Downloads: 904.6K/month (top 5,000 on PyPI)
- Known vulnerabilities: none known

## Tags

django algolia search integration, hosted search for django models, algolia django indexing, full-text search django, django search backend, algolia django auto-indexing, django geo-search, search-indexing, django-integration, hosted-search

[View on SkillFed](https://skillfed.io/packages/algoliasearch-django) · [View on PyPI](https://pypi.org/project/algoliasearch-django/)