---
id: borneo
version: "5.5.0"
license: Universal Permissive License 1.0
license_treatment: unclear
maintenance: active
---

# borneo — Oracle NoSQL Database Python SDK

License: unclear · Maintenance: active · Downloads: 105.5K/mo

## What it is and what it does

Borneo is the official Python SDK for Oracle NoSQL Database, providing a unified client library to interact with Oracle's NoSQL offerings across three deployment models: the cloud service, a local cloud simulator, and on-premise installations. It abstracts away the differences between these environments, allowing the same code to run against any of them with minimal configuration changes.

The SDK handles authentication, connection management, and request/response serialization. It depends on python-dateutil for timestamp handling and requests for HTTP communication. Developers use it to execute queries, perform CRUD operations on tables, manage table schemas and limits, and handle authorization through pluggable providers (signature-based for cloud, token-based for on-premise, or custom for the simulator).

Use it for:

- Build Python applications against Oracle NoSQL Cloud Service using IAM-based authentication and regional endpoints.
- Develop and test locally using the Oracle NoSQL Cloud Simulator before deploying to production.
- Connect to on-premise Oracle NoSQL Database deployments via a proxy service for hybrid or private cloud scenarios.
- Perform ad-hoc queries and data operations in Python scripts against NoSQL tables without writing custom HTTP clients.
- Integrate Oracle NoSQL as a backend data store in Python web applications or microservices.

## Worth the install?

AI-flagged interpretation of the facts above — verify before relying.

Python SDK for connecting to Oracle NoSQL Database (cloud service, simulator, or on-premise) to perform queries, reads, writes, and table operations.

Yes, if you are building Python applications that need to connect to Oracle NoSQL Database in any of its deployment modes. The package is actively maintained, has low install friction, carries no known vulnerabilities, and is marked Production/Stable. The only caveat is that the license treatment is flagged as unclear—verify the Universal Permissive License 1.0 terms match your project's requirements before committing to it.

## Install

pip install borneo
uv add borneo
poetry add borneo

## Installing borneo

Before you install: Low install friction with only two runtime dependencies (python-dateutil and requests). Package is actively maintained with a recent release (4 days old) and marked as Production/Stable.

License in practice: Licensed under Universal Permissive License 1.0, which is OSI-approved and permissive, but the license treatment is marked unclear in the metadata—verify the exact terms apply to your use case before relying on it in proprietary code.

Quickstart:

pip install borneo

from borneo import NoSQLHandle, NoSQLHandleConfig, GetRequest
from borneo.iam import SignatureProvider

provider = SignatureProvider()
config = NoSQLHandleConfig('region-endpoint').set_authorization_provider(provider)
handle = NoSQLHandle(config)
request = GetRequest().set_table_name('my_table').set_key({'id': 1})
result = handle.get(request)

Requires Python 3.12 or later. For cloud service access, the separate oci package must also be installed. On-premise use requires a running Oracle NoSQL Database instance and proxy service.

Verify before relying:

- Whether the Universal Permissive License 1.0 is compatible with your project's licensing requirements (marked unclear in metadata).
- Performance characteristics and throughput limits when connecting to different Oracle NoSQL environments.
- Whether all three environments (cloud service, simulator, on-premise) are equally well-supported in the current version.

## Package facts

- License: Universal Permissive License 1.0 (unclear)
- Python support: unspecified
- Install friction: low
- Maintenance: active
- Downloads: 105.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

oracle nosql python client, nosql database sdk, oracle cloud database driver, nosql query python, oracle database connector, nosql kv store client, oracle cloud simulator, oracle-cloud, nosql-database, database-client

[View on SkillFed](https://skillfed.io/packages/borneo) · [View on PyPI](https://pypi.org/project/borneo/)