couchbase
Python Client for Couchbase
Decision gist · record as of 2026-08-14
Yes, with conditions. Install if you are already committed to Couchbase Server as your database and need a stable, officially-supported Python client. The permissive Apache License 2.0 and active maintenance are strong positives. However, be aware of one known vulnerability (PYSEC-2023-235) that needs verification for this release, and plan for medium install friction on platforms without prebuilt wheels. Not suitable if you need to avoid compiled C++ dependencies or are evaluating database options.AI-flagged interpretation of the facts on this page — verify before relying
Before you install
- Requires a running Couchbase Server instance.
- On source builds, requires C++17 compiler, CMake >= 3.18, OpenSSL development files, and Python development headers.
- Medium install friction due to compiled C++ dependencies (requires C++17 compiler support and OpenSSL).
License · maintenance · safety
Apache License 2.0 (permissive) — Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions. No copyleft obligations.
last release 2026-06-18 (57 days) · last repo commit 2026-08-14 · 248 stars
1 known vulnerabilities (OSV.dev, 2026-08-14) · 859,822 downloads/mo, #4,876 on PyPI
Alternatives
Verify before relying
pip install couchbase
from couchbase.cluster import Cluster
from couchbase.auth import PasswordAuthenticator
cluster = Cluster('couchbase://localhost', PasswordAuthenticator('user', 'password'))
bucket = cluster.bucket('bucket_name')
collection = bucket.default_collection()
result = collection.get('document_id')- Whether PYSEC-2023-235 affects the current 4.6.2 release or has been patched
- Specific performance characteristics or throughput limits under typical workloads
- Full feature parity between 4.x and older 3.x versions beyond stated compatibility
What it is and what it does
The Couchbase Python client is an official SDK for connecting Python applications to Couchbase Server, a distributed NoSQL database. It provides APIs for key-value operations, N1QL queries, full-text search, and analytics, with support for both synchronous and asynchronous patterns. The library is built on top of libcouchbase and requires a C++17 compiler and OpenSSL for compilation from source, though prebuilt wheels are available for Python 3.10, 3.11, and 3.12 on Windows, macOS, and Linux.
The package has been in active development since its first release and is currently in production-stable status. It depends only on typing-extensions for runtime and is actively maintained, with the latest release 57 days old. The library supports Python 3.7 and later, though wheels are provided for more recent versions. Installation typically requires system-level dependencies (compiler, CMake, OpenSSL) unless a prebuilt wheel is available for your platform.
Use it for
- Building web applications that need fast document storage and retrieval with Couchbase as the backend database.
- Running N1QL queries against Couchbase clusters to aggregate or filter document data from Python code.
- Implementing real-time analytics pipelines that read from and write to Couchbase Server.
- Developing microservices that require distributed key-value caching and persistence.
- Migrating from other NoSQL databases to Couchbase while maintaining Python compatibility.
Worth the install?
AI-flagged interpretation of the facts on this page. Verify before relying on it.
Yes, with conditions.
Install if you are already committed to Couchbase Server as your database and need a stable, officially-supported Python client. The permissive Apache License 2.0 and active maintenance are strong positives. However, be aware of one known vulnerability (PYSEC-2023-235) that needs verification for this release, and plan for medium install friction on platforms without prebuilt wheels. Not suitable if you need to avoid compiled C++ dependencies or are evaluating database options.
Install
couchbase on PyPI
Before you install
Medium install friction due to compiled C++ dependencies (requires C++17 compiler support and OpenSSL). Prebuilt wheels available for Python 3.10, 3.11, 3.12 on Windows, macOS, and Linux, reducing friction on common platforms. Active maintenance with recent releases.
Requires a running Couchbase Server instance. On source builds, requires C++17 compiler, CMake >= 3.18, OpenSSL development files, and Python development headers.
License in practice
Licensed under Apache License 2.0 (permissive), allowing commercial and private use with minimal restrictions. No copyleft obligations.
Quickstart
pip install couchbase
from couchbase.cluster import Cluster
from couchbase.auth import PasswordAuthenticator
cluster = Cluster('couchbase://localhost', PasswordAuthenticator('user', 'password'))
bucket = cluster.bucket('bucket_name')
collection = bucket.default_collection()
result = collection.get('document_id')Verify before relying
- Whether PYSEC-2023-235 affects the current 4.6.2 release or has been patched
- Specific performance characteristics or throughput limits under typical workloads
- Full feature parity between 4.x and older 3.x versions beyond stated compatibility
Package facts
| License | Apache License 2.0 permissive |
| Python support | Supports the current Python release >=3.7 |
| Install friction | Medium. Platform-specific wheel |
| Runtime dependencies | 1 packagetyping-extensions |
| Maintenance | Actively maintained 57 days since the last release |
| Last repo commit | |
| First released | |
| Downloads | 859,822 / month, #4,876 on PyPI 30-day window, as of 2026-08-14 |
| Known vulnerabilities | 1 PYSEC-2023-235 |
| Classifiers | Development Status :: 5 - Production/StableIntended Audience :: DevelopersLicense :: OSI Approved :: Apache Software LicenseOperating System :: OS IndependentProgramming Language :: PythonProgramming Language :: Python :: 3Programming Language :: Python :: Implementation :: CPythonTopic :: DatabaseTopic :: Software Development :: LibrariesTopic :: Software Development :: Libraries :: Python Modules |
Evidence: couchbase-4.6.2-cp310-cp310-macosx_10_15_x86_64.whl; couchbase-4.6.2-cp310-cp310-macosx_11_0_arm64.whl; couchbase-4.6.2-cp310-cp310-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; couchbase-4.6.2-cp310-cp310-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; couchbase-4.6.2-cp310-cp310-musllinux_1_2_x86_64.whl; couchbase-4.6.2-cp310-cp310-win_amd64.whl; couchbase-4.6.2-cp311-cp311-macosx_10_15_x86_64.whl; couchbase-4.6.2-cp311-cp311-macosx_11_0_arm64.whl; couchbase-4.6.2-cp311-cp311-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; couchbase-4.6.2-cp311-cp311-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; couchbase-4.6.2-cp311-cp311-musllinux_1_2_x86_64.whl; couchbase-4.6.2-cp311-cp311-win_amd64.whl; couchbase-4.6.2-cp312-cp312-macosx_10_15_x86_64.whl; couchbase-4.6.2-cp312-cp312-macosx_11_0_arm64.whl; couchbase-4.6.2-cp312-cp312-manylinux2014_aarch64.manylinux_2_17_aarch64.whl; couchbase-4.6.2-cp312-cp312-manylinux2014_x86_64.manylinux_2_17_x86_64.whl; couchbase-4.6.2-cp312-cp312-musllinux_1_2_x86_64.whl; couchbase-4.6.2-cp312-cp312-win_amd64.whl; couchbase-4.6.2-cp313-cp313-macosx_10_15_x86_64.whl; couchbase-4.6.2-cp313-cp313-macosx_11_0_arm64.whl
Tags
Let your AI agent find packages like this
Example. Real query, live index.
You found this page by searching. An agent finds it by wishing: SkillFed indexes 14,416 PyPI packages by what they can do, searchable in plain language.
wish › “couchbase python client”
- couchbasePython client library for connecting to and querying Couchbase…
- codewords-clientA Python client library for the Codewords API with built-in FastAPI…
- openapi-python-clientGenerates type-annotated Python HTTP clients from OpenAPI 3.0 and 3.1…
Give your agent the search over MCP, or paste the wish link into any chat.
More Libraries packages
urllib3 is an HTTP client library that provides thread-safe connection pooling, SSL/TLS verification, multipart file uploads, request retries, compression support, and proxy handling for Python applications.
Requests is a Python HTTP library that simplifies sending HTTP/1.1 requests with automatic handling of headers, authentication, cookies, and response parsing.
Pluggy provides a plugin system that lets you define hook specifications and register implementations to be called in sequence, enabling extensible Python applications without tight coupling.
Install it if you're building an extensible application or framework.
Provides parsing, arithmetic, and recurrence rule computation for dates and times, with timezone support and iCalendar RFC compliance.
Install it if you need to parse flexible date strings, compute relative dates, handle timezones, or work with recurrence rules—it's the de facto choice for these tasks.
Six provides utility functions to write Python code that runs on both Python 2.7 and Python 3.3+, smoothing over language differences between the two versions.
pytest is a testing framework that lets you write test functions using plain assert statements and automatically discovers and runs them, with detailed failure reporting.
See also happybase · google-cloud-firestore · google-cloud-datastore · ydb · aerospike · borneo · mysqlclient · pycups · CouchDB · ibmcloudant