DataStax Python Driver for Apache Cassandra®

A Python client driver for Apache Cassandra®. This driver works exclusively with the Cassandra Query Language v3 (CQL3) and Cassandra’s native protocol. Cassandra 2.1+ is supported, including DSE 4.7+.

The driver supports Python 2.7, 3.5, 3.6, 3.7 and 3.8.

This driver is open source under the Apache v2 License. The source code for this driver can be found on GitHub.

Note: DataStax products do not support big-endian systems.



How to install the driver.

Getting Started

A guide through the first steps of connecting to Cassandra and executing queries

Execution Profiles

An introduction to a more flexible way of configuring request execution

Lightweight Transactions (Compare-and-set)

Working with results of conditional requests

Object Mapper

Introduction to the integrated object mapper, cqlengine

Performance Notes

Tips for getting good performance.

Paging Large Queries

Notes on paging large query results


An overview of the security features of the driver


A guide to upgrading versions of the driver

User Defined Types

Working with Cassandra 2.1’s user-defined types

Working with Dates and Times

Some discussion on the driver’s approach to working with timestamp, date, time types


A guide to connecting to Datastax Astra

DSE Geometry Types

Working with DSE geometry types

DataStax Graph Queries

Graph queries with the Core engine

DataStax Classic Graph Queries

Graph queries with the Classic engine

DataStax Graph Fluent API

DataStax Graph Fluent API


Log of changes to the driver, organized by version.

Frequently Asked Questions

A collection of Frequently Asked Questions

API Documentation

The API documentation.

Getting Help

Visit the FAQ section in this documentation.

Please send questions to the mailing list.

Alternatively, you can use the DataStax Community.

Reporting Issues

Please report any bugs and make any feature requests on the JIRA issue tracker.

If you would like to contribute, please feel free to open a pull request.