recall-relay
recall-relay is a small, dependency-free Python client that checks a private Recall workspace before calling Gemini image generation. On a safe reuse match it returns the stored asset; on a miss it calls Gemini with the key in your local process, then captures the resulting bytes in Recall.
Install from GitHub
pip install "git+https://github.com/usv240/recall-generation-memory.git#subdirectory=sdk/python"
For local development:
pip install -e sdk/python
Configure
export RECALL_URL=https://recall-production-production.up.railway.app
export RECALL_WORKSPACE_ID=ws-...
export RECALL_WORKSPACE_KEY=save-the-one-time-key
export GEMINI_API_KEY=your-google-key
Use
recall-relay doctor
recall-relay gemini "Editorial cobalt glass product image" --tag launch --intent brand=Recall --intent format=1:1 --output hero.png
The CLI never prints credentials. gemini calls Google only after Recall?s private workspace returns a safe miss.
OpenAI image generation
Set OPENAI_API_KEY locally and run:
recall-relay openai "Editorial cobalt glass product image" --model gpt-image-1 --output hero.png
Publish to PyPI
The repository includes a secure GitHub Trusted Publishing workflow at .github/workflows/release.yml. Configure PyPI to trust usv240/recall-generation-memory, workflow release.yml, environment pypi, then publish a GitHub Release. No long-lived PyPI token is needed. Until then, the GitHub pip install command above installs the exact public source.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file recall_relay-0.1.0.tar.gz.
File metadata
- Download URL: recall_relay-0.1.0.tar.gz
- Upload date:
- Size: 4.5 kB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
8df9987b5b564adf97eaa3f135383fd54dbd384fdc0de1fa20ba119638686a53
|
|
| MD5 |
44f5bac7d555d89bf32a55e5d05bbc40
|
|
| BLAKE2b-256 |
d01bd4bf8ed875f2ac14920833ce3efb1d43b9fa821f585c813abb5dbf14169d
|
Provenance
The following attestation bundles were made for recall_relay-0.1.0.tar.gz:
Publisher:
release.yml on usv240/recall-generation-memory
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
recall_relay-0.1.0.tar.gz -
Subject digest:
8df9987b5b564adf97eaa3f135383fd54dbd384fdc0de1fa20ba119638686a53 - Sigstore transparency entry: 2251357969
- Sigstore integration time:
-
Permalink:
usv240/recall-generation-memory@58fb9fbb9c90f9d4e29695f4a06122b814f714d8 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/usv240
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@58fb9fbb9c90f9d4e29695f4a06122b814f714d8 -
Trigger Event:
release
-
Statement type:
File details
Details for the file recall_relay-0.1.0-py3-none-any.whl.
File metadata
- Download URL: recall_relay-0.1.0-py3-none-any.whl
- Upload date:
- Size: 5.2 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/6.1.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
e4b98e40ba38e18e986b71e7c11f23b2378c3976c1249a6fce673494488bd345
|
|
| MD5 |
7801a1a49a2c9edf9dafcffd54b60245
|
|
| BLAKE2b-256 |
8cc9dfbd28d47872db1b27fe4aab5ba3ac7bc57ce05a3564e3cf24a7acc1dfb5
|
Provenance
The following attestation bundles were made for recall_relay-0.1.0-py3-none-any.whl:
Publisher:
release.yml on usv240/recall-generation-memory
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
recall_relay-0.1.0-py3-none-any.whl -
Subject digest:
e4b98e40ba38e18e986b71e7c11f23b2378c3976c1249a6fce673494488bd345 - Sigstore transparency entry: 2251358146
- Sigstore integration time:
-
Permalink:
usv240/recall-generation-memory@58fb9fbb9c90f9d4e29695f4a06122b814f714d8 -
Branch / Tag:
refs/tags/v0.1.0 - Owner: https://github.com/usv240
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@58fb9fbb9c90f9d4e29695f4a06122b814f714d8 -
Trigger Event:
release
-
Statement type:
