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.12.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.12.0
File	Size	Uploaded
generic_ml_cache_core-0.12.0.tar.gz	134.5 kB	Jun 25, 2026	Details

Built distribution (wheel)

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

Total release size: 272.7 kB

Release files / generic_ml_cache_core-0.12.0.tar.gz

Download URL	generic_ml_cache_core-0.12.0.tar.gz
Size	134.5 kB
Tags	Source
SHA-256 checksum How to use checksums	`0b8887dec52612bbdcc5a88824ab243d027b087652fca082dcd8afbe0e8fe079`
BLAKE2b-256 checksum How to use checksums	`0fe3c74749ff79963d126df25380bd66c5d35bdde876d09c9ec16734b996d2ee`
Upload date	Jun 25, 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/b5387aa3329ae1912eebb435096999bc56a531e2

Workflow

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

Artifact

Subject: generic_ml_cache_core-0.12.0.tar.gz
SHA-256 checksum: 0b8887dec52612bbdcc5a88824ab243d027b087652fca082dcd8afbe0e8fe079 Verifying attestations

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

Download URL	generic_ml_cache_core-0.12.0-py3-none-any.whl
Size	138.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`11ccd2225e2e88fb56bb7949a2b7d1c33edbc1f04622977c45f2d77c43cd5f8c`
BLAKE2b-256 checksum How to use checksums	`dcf67d732c961cc516d08b17a4619d9ab9b6869780a6d378739400c56c381bbb`
Upload date	Jun 25, 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/b5387aa3329ae1912eebb435096999bc56a531e2

Workflow

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

Artifact

Subject: generic_ml_cache_core-0.12.0-py3-none-any.whl
SHA-256 checksum: 11ccd2225e2e88fb56bb7949a2b7d1c33edbc1f04622977c45f2d77c43cd5f8c Verifying attestations