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.20.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.20.0
File	Size	Uploaded
generic_ml_cache_core-0.20.0.tar.gz	152.8 kB	Jun 28, 2026	Details

Built distribution (wheel)

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

Total release size: 310.0 kB

Release files / generic_ml_cache_core-0.20.0.tar.gz

Download URL	generic_ml_cache_core-0.20.0.tar.gz
Size	152.8 kB
Tags	Source
SHA-256 checksum How to use checksums	`921421ad6105f9fc62cc02e9f775fa7d7a4aa38ae9d5d0756e174a2be598d0d4`
BLAKE2b-256 checksum How to use checksums	`c5e825253dd5473d5130409f6a944c1b26202cd9eaae1833bb4bdde4e9a76e19`
Upload date	Jun 28, 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/80e852a987c1618b94cd2481862ccefa0c6b57d6

Workflow

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

Artifact

Subject: generic_ml_cache_core-0.20.0.tar.gz
SHA-256 checksum: 921421ad6105f9fc62cc02e9f775fa7d7a4aa38ae9d5d0756e174a2be598d0d4 Verifying attestations

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

Download URL	generic_ml_cache_core-0.20.0-py3-none-any.whl
Size	157.3 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`83a14ec3f20067e6cd53682e3d43a03053a7a16fbb3e73f2a53c4f3822a335f5`
BLAKE2b-256 checksum How to use checksums	`f72fe08ec33d01ddfccadfed797c592d7ca367adf84c4b89b091d39c5bcf1bbf`
Upload date	Jun 28, 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/80e852a987c1618b94cd2481862ccefa0c6b57d6

Workflow

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

Artifact

Subject: generic_ml_cache_core-0.20.0-py3-none-any.whl
SHA-256 checksum: 83a14ec3f20067e6cd53682e3d43a03053a7a16fbb3e73f2a53c4f3822a335f5 Verifying attestations