django-clickhouse
Django extension to integrate with ClickHouse database
Decision gist · record as of 2026-08-14
Yes, if you are already committed to ClickHouse and need Django integration—the low install friction, permissive license, and absence of known vulnerabilities make it a reasonable choice. However, verify that infi.clickhouse-orm is still maintained and that the package's dormant status does not hide unresolved compatibility issues with your Django version. Not recommended if you need active development or frequent updates.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a running ClickHouse server instance and infi.clickhouse-orm to be properly configured; Django project setup is also required.
- Low install friction with a pure-Python wheel.
- Maintenance is dormant—last commit was 2025-02-19 but no releases in 541 days, suggesting the package is stable but not actively developed.
License · maintenance · safety
permissive license (permissive) — BSD 3-clause permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.
last release 2025-02-19 (541 days) · last repo commit 2025-02-19 · 105 stars
0 known vulnerabilities (OSV.dev, 2026-08-14) · 185,062 downloads/mo, #10,017 on PyPI
Alternatives
Verify before relying
pip install django-clickhouse
from django_clickhouse import ClickHouseModel
class MyAnalyticsModel(ClickHouseModel):
pass- Whether the package supports modern Django versions (3.2+, 4.x, 5.x) given no Python version constraint is specified.
- Current state of infi.clickhouse-orm dependency and whether it is actively maintained.
- Whether dormant status means the package is production-ready or has unresolved issues.
What it is and what it does
django-clickhouse bridges Django applications and ClickHouse, a high-performance columnar database optimized for analytics and time-series workloads. It provides an ORM-like interface to define models and query ClickHouse tables, integrating with Django's ecosystem through celery for async operations and statsd for monitoring.
The package is designed for teams building analytics pipelines or real-time dashboards within Django projects. It abstracts ClickHouse's native query language and connection handling, letting developers work with familiar Django patterns. With low install friction and a permissive license, it's suitable for both open-source and commercial projects, though its dormant maintenance status means it receives no active updates.
Use it for
- Build analytics dashboards in Django that query ClickHouse for aggregated metrics and time-series data.
- Migrate event logging or metrics collection from a traditional database to ClickHouse for better compression and query speed.
- Define ClickHouse tables as Django models and use celery tasks to batch-insert analytics events asynchronously.
- Integrate ClickHouse reporting into existing Django admin or custom views without rewriting query logic.
- Prototype analytics features in Django before committing to a dedicated analytics platform.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, if you are already committed to ClickHouse and need Django integration—the low install friction, permissive license, and absence of known vulnerabilities make it a reasonable choice.
However, verify that infi.clickhouse-orm is still maintained and that the package's dormant status does not hide unresolved compatibility issues with your Django version. Not recommended if you need active development or frequent updates.
Install
django-clickhouse on PyPI
Before you install
Low install friction with a pure-Python wheel. Maintenance is dormant—last commit was 2025-02-19 but no releases in 541 days, suggesting the package is stable but not actively developed. Depends on Django, celery, infi.clickhouse-orm, pytz, statsd, and typing.
Requires a running ClickHouse server instance and infi.clickhouse-orm to be properly configured; Django project setup is also required.
License in practice
BSD 3-clause permissive license allows commercial and private use with minimal restrictions, requiring only license and copyright notice retention.
Quickstart
pip install django-clickhouse
from django_clickhouse import ClickHouseModel
class MyAnalyticsModel(ClickHouseModel):
passVerify before relying
- Whether the package supports modern Django versions (3.2+, 4.x, 5.x) given no Python version constraint is specified.
- Current state of infi.clickhouse-orm dependency and whether it is actively maintained.
- Whether dormant status means the package is production-ready or has unresolved issues.
Package facts
| License | permissive license permissive |
| Python support | Not specified |
| Install friction | Low. Pure-Python wheel |
| Runtime dependencies | 6 packagesceleryDjangoinfi.clickhouse-ormpytzstatsdtyping |
| Maintenance | Dormant 541 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 185,062 / month, #10,017 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | None known OSV.dev, checked 2026-08-14 |
Evidence: django_clickhouse-1.2.2-py2.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 › “django clickhouse integration”
- django-clickhouseIntegrates Django applications with ClickHouse, a columnar database,…
- django-clickhouse-backendA Django database backend that lets you use Django ORM to query and…
- clickhouse-connectA Python database driver for ClickHouse that supports DataFrames,…
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 dbt-clickhouse · infi.clickhouse-orm · clickhouse-sqlalchemy · clickhouse-connect · django-clickhouse-backend · clickhouse-migrations · clickhouse-driver · airflow-clickhouse-plugin · chdb · djongo