modelvault 0.14.0

Store Pydantic and dataclass models in a typed embedded database — validation, indexes, migrations, single-file deployment.

modelvault (Python)

Store Pydantic models directly

Schema-first typed storage for application models. Official CPython bindings for ModelVault (PyO3).

Store dataclasses and Pydantic v2 models with validation, indexes, migrations, and single-file deployment — no low-level schema JSON required for the recommended path.

Read the docs: modelvault.readthedocs.io

Why ModelVault	Positioning and tradeoffs
Pydantic guide	Model-first schemas
FastAPI guide	Small API services
Quickstart	First insert in minutes
Why ModelVault	Positioning and design goals

Install

CPython 3.9+ · stable ABI wheels (cp39-abi3)

pip install "modelvault>=0.14.0,<0.15"

Quick start (Pydantic)

from pydantic import BaseModel
import modelvault

class Book(BaseModel):
    __modelvault_primary_key__ = "title"
    title: str
    year: int

db = modelvault.Database.open_in_memory()
books = modelvault.models.collection(db, Book)
books.insert(Book(title="ModelVault", year=2020))
print(books.get("ModelVault"))
print(modelvault.__version__)

Output:

title='ModelVault' year=2020
0.14.0

Dataclass example and indexed queries: Quickstart · Python guide

Build from source

Requires Rust, Python 3.9+, and maturin.

cd python/modelvault && maturin develop --release && pytest -q

Contributor layout: python/README.md · full pipeline: make check-full from repo root

License

MIT — LICENSE