Django Cassandra Engine - the Cassandra backend for Django

All tools you need to start your journey with Apache Cassandra and Django Framework!

workflow

Features

integration with latest python-driver and optionally dse-driver from DataStax
full compatibility with ScyllaDB using scylla-driver
working flush, migrate, sync_cassandra, inspectdb and dbshell commands
support for creating/destroying test database
accepts all Cqlengine and cassandra.cluster.Cluster connection options
automatic connection/disconnection handling
works well along with relational databases (as secondary DB)
storing sessions in Cassandra
working django forms
usable admin panel with Cassandra models
support DataStax Astra cloud hosted Cassandra

Installation

Recommended installation:

pip install django-cassandra-engine

Basic Usage

Add django_cassandra_engine to INSTALLED_APPS in your settings.py file:

 INSTALLED_APPS = ('django_cassandra_engine',) + INSTALLED_APPS

Change DATABASES setting:

 DATABASES = {
     'default': {
         'ENGINE': 'django_cassandra_engine',
         'NAME': 'db',
         'TEST_NAME': 'test_db',
         'HOST': 'db1.example.com,db2.example.com',
         'OPTIONS': {
             'replication': {
                 'strategy_class': 'SimpleStrategy',
                 'replication_factor': 1
             }
         }
     }
 }

Define some model:

 # myapp/models.py

 import uuid
 from cassandra.cqlengine import columns
 from django_cassandra_engine.models import DjangoCassandraModel

 class ExampleModel(DjangoCassandraModel):
     example_id    = columns.UUID(primary_key=True, default=uuid.uuid4)
     example_type  = columns.Integer(index=True)
     created_at    = columns.DateTime()
     description   = columns.Text(required=False)

Run ./manage.py sync_cassandra
Done!

ScyllaDB Support

Django Cassandra Engine has full support for ScyllaDB. The package uses scylla-driver, which is ScyllaDB's optimized fork of the DataStax Python driver.

ScyllaDB is a high-performance NoSQL database that is API-compatible with Apache Cassandra. To use Django Cassandra Engine with ScyllaDB, simply configure your database settings to point to your ScyllaDB instance:

    DATABASES = {
        'default': {
            'ENGINE': 'django_cassandra_engine',
            'NAME': 'db',
            'TEST_NAME': 'test_db',
            'HOST': 'scylla-host.example.com',
            'OPTIONS': {
                'replication': {
                    'strategy_class': 'SimpleStrategy',
                    'replication_factor': 1
                }
            }
        }
    }

All features of Django Cassandra Engine work seamlessly with ScyllaDB, including migrations, model operations, and test database management.

Connect to Cassandra with a Cloud Config bundle

To connect to a hosted Cassandra cluster that provides a secure connection bundle (ex. DataStax Astra) change the DATABASES setting of your settings.py:

    DATABASES = {
        'default': {
            'ENGINE': 'django_cassandra_engine',
            'NAME': 'keyspace_name',
            'TEST_NAME': 'table_name',
            'USER': 'token',
            'PASSWORD': token_value,
            'OPTIONS': {
                'connection': {
                    'cloud': {
                        'secure_connect_bundle': '/path/to/secure/bundle.zip'
                    },
                }
            }
        }
    }

Documentation

The documentation can be found online here.

License

Metadata

Release files for django-cassandra-engine 1.11.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distribution (wheel)

Table of built distributions (wheels) for django-cassandra-engine 1.11.0
File	Interpreter	ABI	Platform	Reset
django_cassandra_engine-1.11.0-py3-none-any.whl 37.4 kB Sep 21, 2026	Python 3	none	any	Details

Release files / django_cassandra_engine-1.11.0-py3-none-any.whl

Download URL	django_cassandra_engine-1.11.0-py3-none-any.whl
Size	37.4 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`2453196a9efb24f3d318847def71d9b78283c7e7a389205667b13593ba87187a`
BLAKE2b-256 checksum How to use checksums	`0e32fb2fb0581180ecbc66099769f2b6b3b557f079287398cb4915271c77359b`
Upload date	Sep 21, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	No
Uploaded via	`twine/6.2.0 CPython/3.11.16`