gmlcache

generic-ml-cache-core

The hexagonal engine behind gmlcache — embeddable and stateless

The reusable engine behind gmlcache: record a real ML client (or API) call once, replay it by its content key. It contains the domain model, the use cases, the port contracts, and the default outbound adapters (SQLite execution repository, filesystem blob store, the claude/codex/cursor client runner, the API client, metrics, clock, fingerprinting) — plus the build_use_cases composition factory.

Pure Python and stateless: it bakes in structure (table names, blob naming, schema) but no location — you inject the data source.

Part of a single-user, local tool — not a gateway. gmlcache records and replays across the subscriptions and APIs you already hold; it is not a multi-user router. See Positioning.

Install

pip install generic-ml-cache-core

Embed it

Hand the library a data source and it wires the engine for you:

from generic_ml_cache_core import build_use_cases
from generic_ml_cache_core.application.port.inbound.run_managed_local_execution_command import (
    RunManagedLocalExecutionCommand,
)

wired = build_use_cases(store_root="/path/you/choose")   # you provide the data source
command = RunManagedLocalExecutionCommand(
    client="claude", model="sonnet", effort="", context="", prompt="…",
)
execution = wired.run_managed.execute(command)           # records on a miss, replays on a hit

You reuse the shipped adapters by injecting a data source — you never reimplement them (the Spring Batch model: the framework ships the writers, you provide the connection). Need a different store? Construct the use cases yourself against the ports and pass your own adapter.

What's inside

Domain model — executions, polymorphic call identities, artifacts, usage.
Use cases — managed-local / passthrough / API runs, and probe (check).
Ports (application/port/...) — client runner, blob store, execution repository, metrics, clock, fingerprint, API client.
Default adapters (adapter/out/...) + the build_use_cases composition factory.
generic_ml_cache_core.testing.InMemoryExecutionRepository — an in-memory reference adapter to test your code against the ports.

Inbound drivers — gmlcache today, a daemon later — map their surface (a terminal, a REST API) onto these public APIs; the core itself has no UI and reads no config file.

License

Apache-2.0 — see LICENSE and NOTICE.

Release files for generic-ml-cache-core 0.15.0

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

Source distribution (sdist)

Source distribution for generic-ml-cache-core 0.15.0
File	Size	Uploaded
generic_ml_cache_core-0.15.0.tar.gz	144.3 kB	Jun 26, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for generic-ml-cache-core 0.15.0
File	Interpreter	ABI	Platform	Reset
generic_ml_cache_core-0.15.0-py3-none-any.whl 149.6 kB Jun 26, 2026	Python 3	none	any	Details

Total release size: 294.0 kB

Release files / generic_ml_cache_core-0.15.0.tar.gz

Download URL	generic_ml_cache_core-0.15.0.tar.gz
Size	144.3 kB
Tags	Source
SHA-256 checksum How to use checksums	`e95827a235e4268ba546f1cee21abbe45ca808b49c48d5442eb95be9e84d6dac`
BLAKE2b-256 checksum How to use checksums	`bf577145f508f1b3371f21233265e4b326e344dd9e60179a1ad2b4e61cf3cb03`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

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.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/danielslobozian/generic-ml-cache
Publishing commit: github.com/danielslobozian/generic-ml-cache/tree/3d05aa54bb5a59eaece50d1f0b162abe2b5b89bb

Workflow

Publishing configuration: github.com/danielslobozian/generic-ml-cache/blob/3d05aa54bb5a59eaece50d1f0b162abe2b5b89bb/.github/workflows/release.yml
Publishing logs: github.com/danielslobozian/generic-ml-cache/actions/runs/28269023392/attempts/1

Artifact

Subject: generic_ml_cache_core-0.15.0.tar.gz
SHA-256 checksum: e95827a235e4268ba546f1cee21abbe45ca808b49c48d5442eb95be9e84d6dac Verifying attestations

Release files / generic_ml_cache_core-0.15.0-py3-none-any.whl

Download URL	generic_ml_cache_core-0.15.0-py3-none-any.whl
Size	149.6 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`6784eb41315cdf5b8a50b23e6f451ae5a363281c5e399891fc935a4eccdb0490`
BLAKE2b-256 checksum How to use checksums	`65e29003472f06046406d3ae1858b2254ca58d02d334e293b158838e27453095`
Upload date	Jun 26, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/6.1.0 CPython/3.13.12`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/danielslobozian/generic-ml-cache
Publishing commit: github.com/danielslobozian/generic-ml-cache/tree/3d05aa54bb5a59eaece50d1f0b162abe2b5b89bb

Workflow

Publishing configuration: github.com/danielslobozian/generic-ml-cache/blob/3d05aa54bb5a59eaece50d1f0b162abe2b5b89bb/.github/workflows/release.yml
Publishing logs: github.com/danielslobozian/generic-ml-cache/actions/runs/28269023392/attempts/1

Artifact

Subject: generic_ml_cache_core-0.15.0-py3-none-any.whl
SHA-256 checksum: 6784eb41315cdf5b8a50b23e6f451ae5a363281c5e399891fc935a4eccdb0490 Verifying attestations