Skip to main content

Relayloom

Pay for what arrived. Prove it.

Relayloom matches a supplier bill with the purchase order and with what was actually counted on the dock, holds any payment the goods do not support, and writes signed receipts you can verify with the network off. Muse Glimmer and SAM 3.1, open weight Meta models, run on your own machine.

The paperwork says 50. The dock got 46. relayloom check says HELD, and says why.

python -m pip install relayloom
relayloom doctor

Try it in a minute, no models needed

bill.json (what the bill says), po.json (what was ordered), and a count of what arrived:

relayloom check --bill-json bill.json --po po.json --counted 46
relayloom verify relayloom-out/receipts.jsonl
Bill CAL-0990: billed 50, counted 46. Result: HELD
  - CARTON-HD: billed 50 with 0 already billed, received 46
Signed receipts: relayloom-out/receipts.jsonl   Verify: relayloom verify relayloom-out/receipts.jsonl

Exit code 0 means clear to enter, 3 means held, 2 means it could not run. Add --json for scripts.

Count the goods from photos

python -m pip install "relayloom[models]"
python -m pip install git+https://github.com/ultralytics/CLIP.git   # text prompts for SAM 3.1 (a Git-only dependency, so it is not bundled)
export HF_TOKEN=...            # your own Hugging Face read token (SAM 3.1 needs the access request)
relayloom models pull          # one time; after this everything runs offline
relayloom models serve         # Muse Glimmer on 127.0.0.1, in another terminal
relayloom check --bill bill.pdf --photos dock/ --po po.json --agent

With --agent, Muse Glimmer proposes the words to look for, calls SAM 3.1 as a tool, and looks at the numbered overlay itself. Code owns the number: it is only ever the masks SAM returned, and a count is accepted only when two different words agree, or when Glimmer has looked at the overlay and no other count contradicts it. Otherwise the bill is held for a person.

What it does not do

  • It does not send a bill, a photo or a number anywhere. relayloom doctor and verify make no network calls at all.
  • It does not pay anything. It decides, with evidence, and a person approves what the policy says needs approval.
  • It does not claim real time on a CPU. Counting a photo takes about 40 seconds and reading a bill several minutes on a laptop CPU; measured timings are on the Proof page.

Commands

Command What it does
relayloom check match a bill, a purchase order and the goods; write signed receipts
relayloom verify RECEIPTS check signatures, hashes and chain order offline
relayloom doctor say what is ready and the one command that fixes what is not
relayloom models pull / serve download the models with your own token / start Muse Glimmer locally
relayloom serve the demo app and phone alerts (needs a clone of the repository)

Docs, the policy file and the receipt format: https://relayloom.vercel.app/developers. Source and threat model: https://github.com/Sriharsan/relayloom. MIT licensed.

Metadata

Release files for relayloom 0.3.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 relayloom 0.3.0
File Size Uploaded Provenance Actions
relayloom-0.3.0.tar.gz 120.8 kB Without provenance Details for relayloom-0.3.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for relayloom 0.3.0
File Interpreter ABI Platform Actions
relayloom-0.3.0-py3-none-any.whl Python 3 none any Details for relayloom-0.3.0-py3-none-any.whl

Total release size: 224.0 kB

Release files / relayloom-0.3.0.tar.gz

Download URL relayloom-0.3.0.tar.gz
Size 120.8 kB
Tags Source
SHA-256 checksum
How to use checksums
8cea31e4253a9fb2935d76041e7ffdd26d3ff399a17844909e11847137aa2a83
BLAKE2b-256 checksum
How to use checksums
6db8d0c9aca70da1f34aa81c4c66606f536a1659e44d75aeeae50c61a77b67d2
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Release files / relayloom-0.3.0-py3-none-any.whl

Download URL relayloom-0.3.0-py3-none-any.whl
Size 103.1 kB
Tags Python 3
SHA-256 checksum
How to use checksums
ea6760464433e3d0e6eb02e312d245a5efa7be4da13a35b6cbb8e2eec30bec2d
BLAKE2b-256 checksum
How to use checksums
a0ffbe5ae8db7630f02033772d3f1f58b59ee40cdecb6ff27e672327ce8751e7
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/7.0.0 CPython/3.13.3

Security for relayloom 0.3.0

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.

No provenance found

None of the files in this release were uploaded with provenance metadata.

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.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

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