Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

TinyStore for Python

A small storage runtime for applications. SQL, key-value state, durable jobs, files, search, logs and metrics in one directory, with one lifecycle, one memory budget and one backup.

Not released yet. Until v0.1.0, the API may still change, and a file written by one version may not open in the next.

The SDK starts a small tinystore server next to your program, called the sidecar, and talks to it over a local connection, so that several processes share one store. With embedded=True the core runs inside your process instead. The server and the core come with the wheel, so there is nothing else to install. It runs on Python 3.12 or later, on asyncio.

async with await tinystore.open("data") as store:
    db = await store.database("app", migrations="migrations")
    await db.exec("insert into users (id, name) values (?, ?)", 42, "Ada")

    sessions = store.bucket("sessions", Session, idle="30d")
    await sessions.set(digest(token), Session(user_id=42))

    emails = store.queue("emails", Email)
    await emails.add(Email(to="ada@example.com"))

    avatars = store.files("avatars")
    await avatars.put("42.png", Path("avatar.png").read_bytes())

    store.logger("api").info("user created", user_id=42)
    store.metrics.counter("signups_total").inc()
pip install tinyshed-tinystore

Engines

SQL Relational state Your own SQLite databases: checked migrations, a query builder.
KV Application state Values with expiry and versions; counters, rate limits, quotas, once.
Jobs Background work Work that runs at its time: retries, steps, schedules, limits.
Blobs Files Files by path, written whole or not at all, checked when read.
Search Words and vectors Indexes of documents or of your tables, by words, by meaning, or both.
Channels Messages Messages to whoever listens now, sent from a transaction at its commit.
Locks Coordination Locks and semaphores with fences, across processes and connections.
Config Settings Files and the environment in layers; secrets; settings changed live.
Records Logs and events Read back by time, level, fields and text; followed as they arrive.
Metrics Time series Samples kept bit for bit, answered exactly.
Backup The whole store One checked zip of every engine, taken while it runs.

Documentation

License

Apache-2.0.

Metadata

Release files for tinyshed-tinystore 0.1.0rc6

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for tinyshed-tinystore 0.1.0rc6
File
tinyshed_tinystore-0.1.0rc6-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_x86_64.whl CPython 3.12 abi3 Linux musl 1.2+ x86-64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_aarch64.whl CPython 3.12 abi3 Linux musl 1.2+ ARM64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.28+ ARM64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details
tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_10_13_x86_64.whl CPython 3.12 abi3 macOS 10.13+ x86-64 Details

Total release size: 87.1 MB

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-win_amd64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-win_amd64.whl
Size 11.5 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
e106a505a753f8fac12708bcceca4274754c23bcd869fb9d0e012ad0d16b838a
BLAKE2b-256 checksum
How to use checksums
4fad64d1fb8fed9e85b8b52d0295b468173d5cb6657103e558f472204a4bd9eb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_x86_64.whl
Size 13.3 MB
Tags CPython 3.12 Linux musl 1.2+ x86-64 abi3
SHA-256 checksum
How to use checksums
cd6a4cbd11ab20b29c49c59fb25584b67dcb9beafa8ec05eb5891e7887bdf1c6
BLAKE2b-256 checksum
How to use checksums
27b133cecfa1cb9cb9e0e5cbbe8915e6eae1d00494c7a09be50e73590be6b5d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_aarch64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-musllinux_1_2_aarch64.whl
Size 12.7 MB
Tags CPython 3.12 Linux musl 1.2+ ARM64 abi3
SHA-256 checksum
How to use checksums
b21cf9123141c8463c26add41c649d114bba84127ad413ee896d7defb4a2a0e3
BLAKE2b-256 checksum
How to use checksums
2c6ed29c71351671ff28d1c7080af5096cef921305824a89d7f429a3e1fd6aeb
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_x86_64.whl
Size 13.0 MB
Tags CPython 3.12 Linux glibc 2.28+ x86-64 abi3
SHA-256 checksum
How to use checksums
4cef507ca484e3fcdc79614082652531e0655e8763d9fb9295cb0ad5aa3dc1d2
BLAKE2b-256 checksum
How to use checksums
249a54ba1523807432e78ac1423eafa33b40937f101df015ba5c0b932a63a2d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_aarch64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-manylinux_2_28_aarch64.whl
Size 12.7 MB
Tags CPython 3.12 Linux glibc 2.28+ ARM64 abi3
SHA-256 checksum
How to use checksums
9d54736b4e2255bdf57f7830ff9f00f27e3c35462e0b3a2a2a1a75eb74004a84
BLAKE2b-256 checksum
How to use checksums
ffd7287b1cbecfcc8327b5a5f9b3c8acd043b9b4d8b6988c39d2ba33261d24d3
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_11_0_arm64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_11_0_arm64.whl
Size 11.5 MB
Tags CPython 3.12 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
8742a4900d3d77c2d9dee167e6c561413a01bd8e42d82b4ac274ae95d20009db
BLAKE2b-256 checksum
How to use checksums
5852066b28b7bee8bab43372d097e4f182c8b87818adf663593ec243a2ba994b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Release files / tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_10_13_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc6-cp312-abi3-macosx_10_13_x86_64.whl
Size 12.4 MB
Tags CPython 3.12 abi3 macOS 10.13+ x86-64
SHA-256 checksum
How to use checksums
c96bceb8fd936da03f3ea720ec5e1a345c430c480e7cf78317c90b55a9445dfc
BLAKE2b-256 checksum
How to use checksums
3080f865ad8b3fc214c796ebdbe30a4451f617d582012ff2324e51f4fc5a52e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.14

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

Security for tinyshed-tinystore 0.1.0rc6

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 7 files in this release have been uploaded with provenance metadata.

Select from 7 files

Attestation for tinyshed_tinystore-0.1.0rc6-cp312-abi3-win_amd64.whl

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 19, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page