django-opensearch-dsl

What it is and what it does

Django OpenSearch DSL is a thin wrapper around opensearch-py that allows you to define and manage search indices for Django models. It lets you declaratively map Django model fields to OpenSearch document fields, then automatically keep those indices in sync via Django signals or asynchronous Celery tasks. The package handles index creation, deletion, population, and field mapping—including complex types like nested and object fields—and provides management commands for administrative operations.

You define Document classes that specify which model fields to index and how to configure the OpenSearch index itself (shards, replicas, refresh behavior). The package then manages synchronization: when a model instance is saved or deleted, the corresponding OpenSearch document is updated in real time or queued for async processing. You can query indices using the Search object from opensearch-py, making full-text search, filtering, and aggregations available to your Django application.

Use it for

• Add full-text search to a Django application by indexing model fields and querying them via OpenSearch
• Implement autocomplete or faceted search by leveraging OpenSearch aggregations on indexed model data
• Decouple search from the primary database by maintaining a separate OpenSearch index synchronized via signals
• Perform complex text analysis and linguistic queries that SQL databases cannot efficiently handle
• Scale search performance independently of the main database by tuning OpenSearch shards and replicas per index

Worth the install?

AI-flagged interpretation of the facts on this page. Verify before relying on it.

Install

django-opensearch-dsl on PyPI

Before you install

High install friction due to opensearch-py and python-dateutil dependencies. Maintenance status is aging—last release 263 days ago, though repository remains active with recent commits and no archived status. Supports Django 4.2 through 5.2 and Python 3.9 through 3.13.

Requires a running OpenSearch instance (localhost:9200 by default). OpenSearch server must be accessible and properly configured before indexing operations.

License in practice

Apache Software License 2.0 is permissive, allowing commercial use and modification with minimal restrictions. Suitable for most projects without license compatibility concerns.

Quickstart

pip install django-opensearch-dsl

# In Django settings:
OPENSEARCH_DSL = {'default': {'hosts': 'localhost:9200'}}

# In documents.py:
from django_opensearch_dsl import Document
from django_opensearch_dsl.registries import registry

@registry.register_document
class MyModelDocument(Document):
    class Index:
        name = 'myindex'
    class Django:
        model = MyModel
        fields = ['name', 'description']

Package facts

Evidence: django_opensearch_dsl-0.8.0.tar.gz

Tags

More Front-Ends packages

See also opensearch-dsl · django-elasticsearch-dsl · opensearch-py · elasticsearch-dsl · opensearch-mcp-server-py · modelsearch · elasticsearch8-dsl · django-ordered-model · opensearch-logger · CMRESHandler