TinyDB

Spec sheet

Purpose

TinyDB is a lightweight, document-oriented database intended for small apps that would be poorly served by a SQL database or external database server.Read 9 Oct 2026 · github.com

Security

The security policy asks vulnerability reporters to use GitHub’s private vulnerability reporting feature and says it aims to respond within seven days.Read 4 Oct 2026 · github.com

License

The project metadata identifies the license as MIT.Read 4 Oct 2026 · github.com

Data operations

Its API supports inserting, searching, updating, and removing documents.Read 9 Oct 2026 · tinydb.readthedocs.io

Extensibility

Users can add custom storage implementations and middleware.Read 9 Oct 2026 · tinydb.readthedocs.io

Extensions

The documentation lists community extensions including aiotinydb, tinydb-rust, and tinyrecord.Read 9 Oct 2026 · tinydb.readthedocs.io

Installation

The documentation says to install TinyDB from PyPI with `pip install tinydb`.Read 4 Oct 2026 · tinydb.readthedocs.io

Intended use

TinyDB is aimed at small apps that would be poorly served by a SQL database or an external database server.Read 4 Oct 2026 · github.com

Language and dependencies

TinyDB is written in pure Python and has no external dependencies.Read 9 Oct 2026 · tinydb.readthedocs.io

Limitations

The documentation advises against TinyDB when an application needs multi-process or multi-thread access, table indexes, an HTTP server, relationships, ACID guarantees, or high performance.Read 9 Oct 2026 · tinydb.readthedocs.io

Maintenance

TinyDB is in maintenance mode, with no significant new features or architectural changes planned, though bug fixes and community-contributed features may be released.Read 9 Oct 2026 · github.com

Notable limits

The documentation advises against TinyDB when an application needs multi-process or multi-thread access, indexes, an HTTP server, table relationships, ACID guarantees, or high performance.Read 4 Oct 2026 · tinydb.readthedocs.io

Python support

The project says it has been tested with Python 3.8 through 3.13 and PyPy3.Read 9 Oct 2026 · github.com

Queries

Queries support comparisons, regular expressions, custom tests, nested fields, and logical combinations.Read 9 Oct 2026 · tinydb.readthedocs.io

Security limits

The security policy says TinyDB is not designed for adversarial multi-tenant environments and recommends validating data before storage.Read 4 Oct 2026 · github.com

Security note

The documentation warns that callable query predicates execute in-process and must not come from untrusted or user-controlled input.Read 9 Oct 2026 · tinydb.readthedocs.io

Storage

By default, TinyDB stores data on disk in JSON format.Read 9 Oct 2026 · tinydb.readthedocs.io

Tables

TinyDB supports tables for organizing documents within a database.Read 9 Oct 2026 · tinydb.readthedocs.io

What it is

TinyDB is a tiny, document-oriented database written in pure Python.Read 4 Oct 2026 · tinydb.readthedocs.io

Where Specifiction places it

• Document Databases#22 of 286.6