Installation

Install the driver with pip. Using a virtual environment is the recommended way to install Python packages so start by creating a virtual environment to use:

# Python 2
$ sudo pip install virtualenv && virtualenv ./venv
# Python 3
$ python3 -m venv ./venv

Then use the pip binary from your virtual environment to install the RethinkDB driver:

$ source venv/bin/activate
$ pip install rethinkdb

Usage

You can use the drivers from Python like this:

$ python
from rethinkdb import r

r.connect('localhost', 28015).repl()
r.db('test').table_create('tv_shows').run()
r.table('tv_shows').insert({ 'name': 'Star Trek TNG' }).run()

Note: RethinkDB connection objects are not thread-safe. It’s recommended that applications open a separate connection per thread, or establish a connection pool.

The RethinkDB Python driver includes support for asynchronous connections using both Tornado and Twisted. Read the asynchronous connections documentation for more information.

Next steps