tinydantic

tinydantic is a simple Python object-document mapper (ODM) for the TinyDB document database. It uses Pydantic—the most widely used data validation library—for document model definition and validation.

Note

tinydantic is an experimental project under active development and should not be considered stable for use in a production environment.

Releases follow the SemVer versioning spec:

Major version zero (0.y.z) is for initial development. Anything MAY change at any time. The public API SHOULD NOT be considered stable.

Minor releases may include breaking changes until v1.0 — check the changelog when upgrading.

AI Disclaimer

I started thinking about the idea for this project after discovering TinyDB a couple years ago. However, I never had the time (or a real use case) to finish the implementation. With the release of Claude Fable 5, it seemed like a good opportunity to revisit this idea and try to get an initial prototype of this working with the help of AI. I'm currently experimenting with the implementation generated by Claude to understand what works well and what needs further improvement.

I am not a NoSQL database expert and it's very possible that there are better implementations and/or interfaces than what Claude has produced in this initial prototype. If you find things that are broken, awkward, missing, or don't follow best practices, please feel free to open an issue or a PR to suggest changes. Feedback is welcome!

New here? The Usage section takes you from installation and a quickstart through queries, storage backends, and FastAPI integration.