elasticsearch8-dsl
Python client for Elasticsearch
Decision gist · record as of 2026-08-14
No. The repository is archived and abandoned with no releases since 2024-01-19 and last commit on 2025-04-18. While the code is permissively licensed and currently has no known vulnerabilities, the lack of active development means security patches, compatibility fixes, and bug fixes will not be forthcoming. Use only if maintaining a legacy application already on this version.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a running Elasticsearch 8.x instance; the library version must match the major version of your Elasticsearch server.
- Low install friction with only two runtime dependencies (python-dateutil and elasticsearch8).
- However, the repository is archived and marked abandoned, with the last commit on 2025-04-18 and no releases since 2024-01-19—maintenance has effectively stopped.
License · maintenance · safety
Apache-2.0 (permissive) — Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
last release 2024-01-19 (938 days) · last repo commit 2025-04-18 · 3,869 stars · archived
0 known vulnerabilities (OSV.dev, 2026-08-14) · 118,614 downloads/mo, #12,111 on PyPI
Alternatives
Verify before relying
pip install elasticsearch8-dsl
from elasticsearch8_dsl import Search
from elasticsearch import Elasticsearch
client = Elasticsearch("https://localhost:9200")
s = Search(using=client, index="my-index").filter("term", category="search").query("match", title="python")
response = s.execute()- Whether the abandoned status and lack of recent releases pose a risk for future Elasticsearch server compatibility.
- Whether security patches or bug fixes will be backported if vulnerabilities are discovered in dependencies.
- Current production usage and whether alternatives are actively maintained.
What it is and what it does
elasticsearch8-dsl is a Python wrapper around the official elasticsearch8 client that replaces verbose JSON dict-based query construction with a chainable, Pythonic API. Instead of manually nesting dictionaries to build bool queries, filters, and aggregations, you write method chains that the library translates to equivalent Elasticsearch JSON DSL. It also provides optional document mapping and persistence—you can define Python classes with typed fields that mirror Elasticsearch mappings, then save and retrieve documents as Python objects.
The library stays structurally close to Elasticsearch's native DSL terminology, so queries remain recognizable to anyone familiar with the JSON syntax. It includes a Search class for query building, aggregation support, and a Document base class for object-relational mapping. You can also convert between Search objects and raw dicts, allowing gradual migration from pure elasticsearch8 code.
Use it for
- Build complex Elasticsearch queries programmatically without manually constructing nested JSON dicts.
- Define document schemas with typed fields and save/retrieve them as Python objects instead of raw dicts.
- Add filters, aggregations, and query clauses dynamically to a search object before execution.
- Migrate incrementally from elasticsearch8 by wrapping existing query dicts and modifying them via the DSL.
- Implement custom document methods and lifecycle hooks for domain logic.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
No.
The repository is archived and abandoned with no releases since 2024-01-19 and last commit on 2025-04-18. While the code is permissively licensed and currently has no known vulnerabilities, the lack of active development means security patches, compatibility fixes, and bug fixes will not be forthcoming. Use only if maintaining a legacy application already on this version.
Install
elasticsearch8-dsl on PyPI
Before you install
Low install friction with only two runtime dependencies (python-dateutil and elasticsearch8). However, the repository is archived and marked abandoned, with the last commit on 2025-04-18 and no releases since 2024-01-19—maintenance has effectively stopped.
Requires a running Elasticsearch 8.x instance; the library version must match the major version of your Elasticsearch server.
License in practice
Licensed under Apache-2.0 (permissive), allowing use in commercial and proprietary projects with minimal restrictions beyond attribution and liability disclaimers.
Quickstart
pip install elasticsearch8-dsl
from elasticsearch8_dsl import Search
from elasticsearch import Elasticsearch
client = Elasticsearch("https://localhost:9200")
s = Search(using=client, index="my-index").filter("term", category="search").query("match", title="python")
response = s.execute()Verify before relying
- Whether the abandoned status and lack of recent releases pose a risk for future Elasticsearch server compatibility.
- Whether security patches or bug fixes will be backported if vulnerabilities are discovered in dependencies.
- Current production usage and whether alternatives are actively maintained.
Package facts
| License | Apache-2.0 permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 2 packagespython-dateutilelasticsearch8 |
| Maintenance | Abandoned 938 days since the last release |
| Last repo commit | repository archived |
| First released | |
| Downloads | 118,614 / month, #12,111 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
| Classifiers | Development Status :: 4 - BetaIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: 3 :: OnlyProgramming Language :: Python :: 3.10Programming Language :: Python :: 3.11Programming Language :: Python :: 3.12Programming Language :: Python :: 3.7Programming Language :: Python :: 3.8Programming Language :: Python :: 3.9Programming Language :: Python :: Implementation :: CPythonProgramming Language :: Python :: Implementation :: PyPy |
Evidence: elasticsearch8_dsl-8.12.0-py3-none-any.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “elasticsearch query builder python”
- elasticsearch8-dslA high-level Python query builder for Elasticsearch that translates…
- elasticsearch-dslProvides a high-level Python API for building and executing…
- luqumParses Lucene Query DSL syntax into an abstract syntax tree, enabling…
Give your agent the search over MCP, or paste the wish link into any chat.
More Front-Ends packages
SQLAlchemy is a Python SQL toolkit and Object Relational Mapper (ORM) that provides both a high-level ORM layer for declarative object persistence and a Core SQL construction system for direct database abstraction and query building.
psycopg2-binary is a PostgreSQL database adapter for Python that implements the DB API 2.0 specification, enabling Python applications to connect to and query PostgreSQL databases with thread-safe concurrent operations.
Alembic generates and manages database schema migrations for SQLAlchemy applications, handling version control of database structure changes with support for upgrades, downgrades, and auto-generation from model changes.
Install it if you use SQLAlchemy and need to version-control schema changes; skip it only if you manage migrations manually or use a different ORM entirely.
A Python client library for connecting to and querying Weaviate, a vector database that enables semantic search and AI-powered data retrieval.
A Python client library that connects to Databricks clusters and SQL warehouses using a Thrift-based protocol, conforming to the Python DB API 2.0 specification and supporting Arrow-based data exchange.
Install it if you need to query Databricks clusters or SQL warehouses from Python.
Psycopg 3 is a PostgreSQL database adapter for Python that enables applications to connect to, query, and manage PostgreSQL databases using Python code.
Install it if you need to connect Python to PostgreSQL.
See also elasticsearch-dsl · luqum · django-elasticsearch-dsl · elasticsearch5 · elasticsearch · elasticsearch6 · opensearch-dsl · elasticsearch9 · django-elasticsearch-dsl-drf · es-client