skillfed

CouchDB

Python library for working with CouchDB

couchdb v1.2 300.2K downloads/30d#7,846 on PyPI206
Permissive license BSD Abandoned released

What it is and what it does

CouchDB-Python is a client library for working with CouchDB, a document-oriented database. It provides four main modules: a basic client library, a design document manager, an object-mapping layer that bridges CouchDB documents and Python objects, and a view server for writing view functions in Python. The package also includes command-line utilities for dumping and loading databases, and for triggering replication.

However, this package has been unmaintained since 2019 and its repository is archived. The original maintainer explicitly recommends an alternative and is no longer addressing issues or bug reports. It should be considered for legacy systems only, not for new projects.

Use it for:

  • Querying and updating documents in an existing CouchDB instance from Python code
  • Automating database administration tasks like snapshots and replication via command-line tools
  • Mapping CouchDB documents to Python objects for application logic in older codebases
  • Writing custom view functions in Python instead of JavaScript for CouchDB design documents

Worth the install?

AI-flagged interpretation of the facts on this page — verify before relying

A Python client library for interacting with CouchDB databases, providing document CRUD operations, design document management, object-to-document mapping, and command-line tools for database administration.

No, unless you are maintaining legacy code already using this library. The package is abandoned (last release 2018-02-09, last commit 2019-03-26, repository archived), and the maintainer explicitly recommends alternatives for new work. No known vulnerabilities exist, but lack of maintenance means security issues and compatibility problems will not be addressed.

Install

couchdb on PyPI

pip

pip install couchdb

uv

uv add couchdb

poetry

poetry add couchdb

Installing CouchDB

Before you install

Installation is low-friction (pure Python wheel), but the package is abandoned as of 2019 with no active maintenance. The maintainer explicitly recommends considering an alternative. Use only if you are committed to maintaining a fork or working with legacy systems.

License in practice

BSD license is permissive and imposes no restrictions on use, modification, or distribution in proprietary or open-source projects.

Quickstart

pip install CouchDB==1.2

from couchdb import Server

server = Server('http://localhost/')
db = server['mydb']
doc = db['docid']
print(doc)

Requires a running CouchDB server (0.10.x or later) accessible at the specified URL; Python 2.7 or 3.4+ as stated in package metadata.

Verify before relying

  • Whether the package remains compatible with modern CouchDB server versions beyond 0.10.x
  • Current state of simplejson optional dependency and whether it is still beneficial
  • Whether Python 3.4 and 3.5 support claims remain valid given the 2019 abandonment date

Package facts

License BSD (permissive)
Python support not specified
Install friction low — pure-Python wheel
Runtime dependencies none
Maintenance abandoned — 3,108 days since the last release
Last repo commit (repository archived)
First released
Downloads 300,152/month — #7,846 on PyPI (30-day window, as of 2026-08-14)
Known vulnerabilities none known (OSV.dev, checked 2026-08-14)

Evidence: CouchDB-1.2-py2.py3-none-any.whl

Development Status :: 6 - MatureIntended Audience :: DevelopersLicense :: OSI Approved :: BSD LicenseOperating System :: OS IndependentProgramming Language :: Python :: 2Programming Language :: Python :: 2.7Programming Language :: Python :: 3Programming Language :: Python :: 3.4Programming Language :: Python :: 3.5Topic :: Database :: Front-EndsTopic :: Software Development :: Libraries :: Python Modules

Tags

couchdb python clientdocument database librarynosql database interfacecouchdb mapping ormdatabase dump and load toolspython couchdb driverdesign document management
abandonedlegacy-onlynosql

More Python Modules packages