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.5.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.5.0
File Size Uploaded Provenance Actions
relayloom-0.5.0.tar.gz 129.4 kB Without provenance Details for relayloom-0.5.0.tar.gz

Built distribution (wheel)

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

Total release size: 239.8 kB

Release files / relayloom-0.5.0.tar.gz

Download URL relayloom-0.5.0.tar.gz
Size 129.4 kB
Tags Source
SHA-256 checksum
How to use checksums
dae6523d8df76988d2eceb60935e6427bb71ddf7496b8e4aa39a559823c5ccc4
BLAKE2b-256 checksum
How to use checksums
0cf0cf95ca2a2b5fc61cb2c376dbc96851dd12a8a42d0819567c535d1fe9dcf8
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.5.0-py3-none-any.whl

Download URL relayloom-0.5.0-py3-none-any.whl
Size 110.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
5b74aaa7d4d0e99a182374e4fd9da712231c3fd0e44d02581355ad590bca8d94
BLAKE2b-256 checksum
How to use checksums
fef2fe2ae9b94f108b270d8cd2c276dea428fce691a24b622402aab599ebe8ff
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.5.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