nucliadb-models

library6.13.0.post6240pypypiunverified

Data models and validation for NucliaDB, the AI-powered search database. Version 6.13.0.post6240 supports Python 3.10-3.12. Released as part of the nucliadb project, with frequent releases following nucliadb's release cadence.

database llm-agents ai-ml vector-search serialization

pip install nucliadb-models

github ↗package ↗homepage ↗

INSTALL

IMPORT

SIG · NUCLIADB-MODELS

nucliadb-models

databasepythonv6.13.0.post6240

harness data pending

Install & Compatibility

Where this runs

No compatibility data collected yet for this library.

Code

Verified usage

Verified import paths — ran on the pinned version, not inferred.

Resource

✓ from nucliadb_models.resource import Resource

✗ from nucliadb_models.resource import Resource

Create a NucliaDB resource model and serialize to JSON.

from nucliadb_models.resource import Resource from nucliadb_models.text import TextField resource = Resource( slug="example", texts={"en": TextField(body="Hello world")} ) print(resource.model_dump_json(indent=2))

Debug

Known issues

breakingIn v6.0.0, the package was renamed from nucliadb-models to nucliadb_models. All imports must use underscores.

fix

Use `from nucliadb_models import ...` instead of `from nucliadb.models import ...`

affects: >=6.0.0

deprecatedThe `Field` class from nucliadb_models.field is deprecated in favor of direct field classes like `TextField`, `FileField`.

fix

Replace `from nucliadb_models.field import Field` with specific field imports like `from nucliadb_models.text import TextField`

affects: >=6.5.0

gotchaModel validation is strict: unknown fields raise a ValidationError by default. This differs from older pydantic v1 behavior.

fix

Use `model_extra = 'allow'` in config if you need to allow extra fields.

affects: >=6.0.0

Upgrade

Version history

6.13.0.post6240latest on PyPI · released May 8, 2026

Audit

Dependencies

pydanticrequiredcore dependency for data models

protobufrequiredused for serialization

Agent activity

48 hits · last 30 days

node

OpenAI (training)

Resources

githubhttps://github.com/nuclia/nucliadb ↗

packagehttps://pypi.org/project/nucliadb-models/ ↗

homepagehttps://nuclia.com ↗