time2relax - Python CouchDB driver

PyPI version Build status Coverage status Documentation status

A CouchDB driver for Python.


  • Runs python-requests under the hood.
  • Only a minimum level of abstraction between you and CouchDB.
  • Transparent URL and parameter encoding.
  • Exceptions are modelled from CouchDB errors.
  • Python 2.7 & 3.3–3.5 support.
  • Tested with CouchDB 1.6.x (2.0?).


Install the latest time2relax if you haven’t yet:

$ pip install -U time2relax

To use time2relax in a project:

>>> from time2relax import CouchDB
>>> db = CouchDB('http://localhost:5984/dbname')


>>> db.insert({'title': 'Ziggy Stardust'})
<Response [201]>