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.4.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.4.0
File Size Uploaded Provenance Actions
relayloom-0.4.0.tar.gz 126.1 kB Without provenance Details for relayloom-0.4.0.tar.gz

Built distribution (wheel)

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

Total release size: 233.8 kB

Release files / relayloom-0.4.0.tar.gz

Download URL relayloom-0.4.0.tar.gz
Size 126.1 kB
Tags Source
SHA-256 checksum
How to use checksums
cd882cdb792406c1aabc4630c828d66465a07a856277cd00a0b86f7b7e9d0fe7
BLAKE2b-256 checksum
How to use checksums
72ab2f97313d68760ecbc944c0427a34681721821dff49b8785887483d7571af
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.4.0-py3-none-any.whl

Download URL relayloom-0.4.0-py3-none-any.whl
Size 107.7 kB
Tags Python 3
SHA-256 checksum
How to use checksums
90e82b0c9582f6b47914561911904ee4fa68566beb8dbf36e1d42401fc1481c8
BLAKE2b-256 checksum
How to use checksums
656a7ca5593e75909537ba0bfb5df0d38d253b9c207503578cec99cfb3f6971e
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.4.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