---
id: nucliadb-utils
version: "7.1.0.post7000"
license: Apache-2.0
license_treatment: permissive
maintenance: active
---

# nucliadb-utils — NucliaDB util library

License: permissive · Maintenance: active · Downloads: 83.5K/mo

## What it is and what it does

nucliadb-utils is a utility library that supports interaction with NucliaDB, an open-source hybrid search database written in Rust and Python. NucliaDB indexes unstructured data using vector embeddings, full-text search, and graph indexes, and is designed for multi-tenant deployments. This package provides helper functions and data structures to work with NucliaDB's APIs and data models.

The package depends on standard Python libraries for async HTTP (aiohttp, httpx), configuration (pydantic, pydantic-settings), authentication (PyNaCl, pyjwt), and observability (prometheus-client, nucliadb-telemetry). It is actively maintained, supports modern Python versions, and carries no known security vulnerabilities.

Use it for:

- Building client applications that query NucliaDB for semantic or full-text search over unstructured documents.
- Integrating NucliaDB into data pipelines that require hybrid search across vectors, keywords, and graph relationships.
- Developing multi-tenant applications that leverage NucliaDB's cloud-native architecture for data storage and retrieval.
- Prototyping NLP-driven search features without implementing vector indexing or full-text search from scratch.

## Worth the install?

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

Provides utility functions and data structures for interacting with NucliaDB, a hybrid search database that indexes unstructured data using vector, full-text, and graph indexes.

Yes. The package is actively maintained, has low install friction, carries permissive Apache-2.0 licensing, and reports no known security vulnerabilities. Install it if you are building applications that depend on NucliaDB or need its utility functions. The main caveat is that the fact sheet does not detail the public API, so verify that the specific utilities you need are actually exported before committing to a dependency.

## Install

pip install nucliadb-utils
uv add nucliadb-utils
poetry add nucliadb-utils

## Installing nucliadb-utils

Before you install: Low friction installation with a pure-Python wheel. Actively maintained with recent releases. Depends on 15 runtime packages including pydantic, aiohttp, and cryptographic libraries; all are standard ecosystem choices.

License in practice: Licensed under Apache-2.0 (permissive), allowing use in commercial and private projects with minimal restrictions. You may modify and distribute the package freely provided you include a copy of the license.

Quickstart:

pip install nucliadb-utils

from nucliadb_utils import <utility_function>
# Use utility functions for NucliaDB interaction

Requires Python 3.10 or later (supports 3.10, 3.11, 3.12); does not support earlier versions.

Verify before relying:

- What specific utility functions and data structures this package exports (fact sheet does not itemize the public API).
- Whether this package is intended for direct end-user use or primarily as an internal dependency of nucliadb itself.
- Performance characteristics or scalability limits for the utilities provided.

## Package facts

- License: Apache-2.0 (permissive)
- Python support: supports_current
- Install friction: low
- Maintenance: active
- Downloads: 83.5K/month (top 15,000 on PyPI)
- Known vulnerabilities: none known

## Tags

nucliadb client utilities, hybrid search database library, vector and full-text search, unstructured data indexing, nucliadb integration helpers, semantic search utilities, database abstraction layer, search-indexing, nlp-infrastructure, hybrid-search

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