Skip to content
A Python library for Cloudant and CouchDB
Branch: master
Clone or download
smithsz Merge pull request #444 from cloudant/add-readme-to-meta
Include README in package metadata.
Latest commit 63d7f04 Mar 28, 2019
Type Name Latest commit message Commit time
Failed to load latest commit information.
.github Template updates (#391) Jun 20, 2018
docs Update version to 2.12.1-SNAPSHOT. Mar 28, 2019
src/cloudant Update version to 2.12.1-SNAPSHOT. Mar 28, 2019
tests Add partitioned databases feature. Mar 26, 2019
.gitignore Added emacs temp files to .gitignore. Dec 11, 2014
.travis.yml Added test attributes Oct 8, 2018 Prepare version 2.12.0 release. Mar 27, 2019 Added test attributes Oct 8, 2018
Jenkinsfile Use system Python installs in Jenkinsfile. Mar 26, 2019
LICENSE Initial commit Jul 9, 2014 Added VERSION file to manifest Feb 16, 2018
VERSION Update version to 2.12.1-SNAPSHOT. Mar 28, 2019
pylintrc Fixed pylint error messages Aug 15, 2018
requirements.txt Implement method to create Cloudant client from VCAP services env Dec 14, 2016 Include README in package metadata. Mar 28, 2019

Cloudant Python Client

Build Status Readthedocs Compatibility pypi

This is the official Cloudant library for Python.

Installation and Usage

Released versions of this library are hosted on PyPI and can be installed with pip.

In order to install the latest version, execute

pip install cloudant

Getting started

See Getting started (

API Reference

See API reference docs (

Related Documentation



Using in other projects

The preferred approach for using python-cloudant in other projects is to use the PyPI as described above.

Examples in open source projects

Getting Started with Python Flask on IBM Cloud

Movie Recommender Demo:

Watson Recipe Bot:


Copyright © 2015 IBM. All rights reserved.

Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file except in compliance with the License. You may obtain a copy of the License at

Unless required by applicable law or agreed to in writing, software distributed under the License is distributed on an "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the License for the specific language governing permissions and limitations under the License.


Before opening a new issue please consider the following:

  • Only the latest release is supported. If at all possible please try to reproduce the issue using the latest version.
  • Please check the existing issues to see if the problem has already been reported. Note that the default search includes only open issues, but it may already have been closed.
  • Cloudant customers should contact Cloudant support for urgent issues.
  • When opening a new issue here in github please complete the template fully.
You can’t perform that action at this time.