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.0rc7

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.0rc7
File
tinyshed_tinystore-0.1.0rc7-cp312-abi3-win_amd64.whl CPython 3.12 abi3 Windows x86-64 Details
tinyshed_tinystore-0.1.0rc7-cp312-abi3-musllinux_1_2_x86_64.whl CPython 3.12 abi3 Linux musl 1.2+ x86-64 Details
tinyshed_tinystore-0.1.0rc7-cp312-abi3-musllinux_1_2_aarch64.whl CPython 3.12 abi3 Linux musl 1.2+ ARM64 Details
tinyshed_tinystore-0.1.0rc7-cp312-abi3-manylinux_2_28_x86_64.whl CPython 3.12 abi3 Linux glibc 2.28+ x86-64 Details
tinyshed_tinystore-0.1.0rc7-cp312-abi3-manylinux_2_28_aarch64.whl CPython 3.12 abi3 Linux glibc 2.28+ ARM64 Details
tinyshed_tinystore-0.1.0rc7-cp312-abi3-macosx_11_0_arm64.whl CPython 3.12 abi3 macOS 11.0+ ARM64 Details
tinyshed_tinystore-0.1.0rc7-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.0rc7-cp312-abi3-win_amd64.whl

Download URL tinyshed_tinystore-0.1.0rc7-cp312-abi3-win_amd64.whl
Size 11.5 MB
Tags CPython 3.12 Windows x86-64 abi3
SHA-256 checksum
How to use checksums
3a079d908013a879391fdceeb8a7ca5b7f90ed675310987fb73879c6e1c8e144
BLAKE2b-256 checksum
How to use checksums
211fc83c7c453bf9c9631283ac675fff17e90f0f6aab49bdccb745bf19075ee7
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.0rc7-cp312-abi3-musllinux_1_2_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
6b78b8ccc58e1250c6f33764fb65d20d24a81d0974c2d50246686b19bebe2917
BLAKE2b-256 checksum
How to use checksums
8907212c9545631d420d7dcc91a451094d915190eb63ab2a422fd1caae87318b
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.0rc7-cp312-abi3-musllinux_1_2_aarch64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
24eeb5e31e884238177c46e7bba1b89e7e3c373a72b9899d1b25d0f96b12f330
BLAKE2b-256 checksum
How to use checksums
713a19958a7e8075b6ba8ae3b33a9007a5ebaaee5fa85d6f2d6abb6d3022950d
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.0rc7-cp312-abi3-manylinux_2_28_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
bde350e1038373cd158a4122a6bbb2ac9064fad7e96b599f1976092ae6828b27
BLAKE2b-256 checksum
How to use checksums
55835ca124c3ec62f2a5f79cb2be443e8f8da79f35bc117e6f4a775e6d130664
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.0rc7-cp312-abi3-manylinux_2_28_aarch64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
8823572972985ba35390f4ff68c2e028922eedc096e0769d4f92537212a95b48
BLAKE2b-256 checksum
How to use checksums
838fc844fd624b09250c8e447e6c1f7dcef2556ab86bc069ee420c9f91d577a5
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.0rc7-cp312-abi3-macosx_11_0_arm64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
92a9f6441f97850d0bd24245f2c4e03e523973673245006a4a985876fadedfce
BLAKE2b-256 checksum
How to use checksums
fe5e63c2a0162b454d1896af37c963333bb9f8f8df7751e47371e8eef00c2bb4
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.0rc7-cp312-abi3-macosx_10_13_x86_64.whl

Download URL tinyshed_tinystore-0.1.0rc7-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
ee999c4a49a52185f163c6f5b1fa93a01d78dee6194698fb9ecef12871e456d6
BLAKE2b-256 checksum
How to use checksums
3bd0b1a0e9c9961bb000b3deb5bc87e45f8ca7427e98e5d3b3cfe364798afb1c
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.0rc7

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.0rc7-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