Relay local-sidecar
Local-only FastAPI + aiosqlite process that the Relay SDK and CLI attach to. Single instance per host, serialized via the four-state lockfile classifier (spec H.5).
This is the W2 milestone package. W2.1 (this commit) lands the lockfile +
spawn semantics, the local_atomic_file_write atomic-persistence
primitive, and the /health nonce challenge. Later sub-features
(W2.2-W2.7) layer on the asyncio runtime, aiosqlite WAL, state engine,
event log, quiesce protocol, and crash recovery.
Status
W2.1 scaffold. Not yet runnable as a daemon - the CLI entrypoint lands in
W5 (rly sidecar start). The library surface (relay_sidecar.spawn,
relay_sidecar.primitives.local_atomic_file_write) is exercised by tests
under tests/.
Anchors
- Spec:
planning/epochly-replay-spec.mdsection H.5 (lockfile four-state classifier), section H (four atomic-persistence primitives). - CLAUDE.md keystone invariant #3 (manifest source of truth) + #8 (atomic persistence via four primitives).
- Contract:
relay-v0.1-oss-wedge/contract.mdVAL-W2-001 .. VAL-W2-011.
ASCII-only
Per CLAUDE.md ASCII-Safe Source, all files under apps/ are ASCII-only.
1 maintainer
Metadata
1 maintainer
Release files for epochly-relay-sidecar 0.1.20
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| epochly_relay_sidecar-0.1.20.tar.gz | 175.5 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| epochly_relay_sidecar-0.1.20-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 377.7 kB
Release files / epochly_relay_sidecar-0.1.20.tar.gz
| Download URL | epochly_relay_sidecar-0.1.20.tar.gz |
|---|---|
| Size | 175.5 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
ef63f865bb7779d1ae7f9694a2e4bed58272f7e2f380cba27d36f8b14624b4a6
|
|
BLAKE2b-256 checksum How to use checksums |
50bf55f28eddc9a1b1c079d8c7a8483379c3a31058ebc868bc80b8f1baab4b1e
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 28, 2026.
Transparency logRelease files / epochly_relay_sidecar-0.1.20-py3-none-any.whl
| Download URL | epochly_relay_sidecar-0.1.20-py3-none-any.whl |
|---|---|
| Size | 202.2 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c2ad1d6ab3491ce5ab33bc2c4bac2057d40ddcba95abc2c34b6ef3bedda2870b
|
|
BLAKE2b-256 checksum How to use checksums |
70c62e759ba25a94e5673b67306631dbe149c5d1c9c4701f5164aca90759bbac
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.13
|
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.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on May 28, 2026.
Transparency log
