REFLUX
REsilient Low-frequency Universal eXchange
Out-of-band AI communication when the internet fails. Transmit AI intents over radio frequencies, satellite, or phone lines.
📡 ─────────────── 📻
│ │
[AI-1] [AI-2]
│ │
└── REFLUX LINK ───┘
Why REFLUX?
When networks go down, AI agents shouldn't. REFLUX provides a fallback communication layer that works over:
- 📻 Ham Radio (HF/VHF bands)
- 📡 Satellite links
- ☎️ PSTN (Plain old telephone)
- 🔊 Acoustic (direct audio)
Using SSTV (Slow Scan TV) encoding, messages are converted to images, then to audio signals that can traverse any analog channel.
Installation
pip install reflux
# With full encoding support:
pip install reflux[full]
Quick Start
from reflux import Channel, Message, Intent
# Create a message
msg = Message(
intent=Intent.STATUS,
payload={"agent": "sentinel-1", "health": "ok"},
sender="root_ai",
receiver="backup_ai"
)
# Send via SIP trunk
channel = Channel.SIP("192.168.4.75", port=5060)
channel.connect()
channel.send(msg)
# Or via Ham Radio
channel = Channel.HamRadio(
frequency="14.230MHz",
callsign="PA3XYZ",
mode="SSTV"
)
channel.connect()
channel.send(msg)
Protocol
REFLUX messages are encoded as:
- Message → JSON with intent, payload, metadata
- Image → QR code + text fallback (320x256)
- Audio → SSTV encoding (Robot36: ~36 seconds)
- Transmission → Over any analog channel
Decoding reverses the process: Audio → Image → QR decode → Message
Transmission Times
| Mode | Time | Use Case |
|---|---|---|
| Robot36 | 36s | Quick status |
| Robot72 | 72s | Standard message |
| Martin1 | 114s | High quality |
| Scottie1 | 110s | Alternative |
Use Cases
- Disaster Recovery: AI agents stay connected when infrastructure fails
- Remote Locations: Research stations, ships, rural areas
- Air-Gapped Systems: Communicate without network connectivity
- Redundancy: Backup channel for critical systems
Part of HumoticaOS
REFLUX is part of the HumoticaOS ecosystem:
- TIBET: Provenance and trust chain
- AInternet: AI agent network (.aint domains)
- Sentinel: Hardware command validation
- Sensory: Audio/visual processing
License
MIT License - Part of HumoticaOS
One Love, One fAmIly! 💙
Metadata
Release files for reflux-protocol 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | Actions |
|---|---|---|---|---|
| reflux_protocol-0.1.0.tar.gz | 7.0 kB | Without provenance | Details for reflux_protocol-0.1.0.tar.gz |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Actions Reset |
|---|---|---|---|---|
| reflux_protocol-0.1.0-py3-none-any.whl | Python 3 | none | any | Details for reflux_protocol-0.1.0-py3-none-any.whl |
Total release size: 14.8 kB
Release files / reflux_protocol-0.1.0.tar.gz
| Download URL | reflux_protocol-0.1.0.tar.gz |
|---|---|
| Size | 7.0 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
682d0fbbccb82272d96ae88b1672ca1e40174ee5a5226441f83dba04cbc35828
|
|
BLAKE2b-256 checksum How to use checksums |
a6d3d70462c2a071694e57d6b8f9bc177a0223e01271279d04a9d1b048662584
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Release files / reflux_protocol-0.1.0-py3-none-any.whl
| Download URL | reflux_protocol-0.1.0-py3-none-any.whl |
|---|---|
| Size | 7.9 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
c79e0a4add4726a547cae2f3a0e1dd16acb28cd5ac1dada2c76cfb24a143ed66
|
|
BLAKE2b-256 checksum How to use checksums |
37c825e299d3821ffeddd63c8873afd8ee65aecb622b42d22d31b7b30297bafa
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.13.5
|
Security for reflux-protocol 0.1.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.