Understand the design decisions and protocol concepts that shape Zoomies. Each concept maps to a layer in the protocol stack.
What Do You Need?
Sans-I/O Pattern
How Zoomies separates protocol logic from network I/O.
Connection Lifecycle
QUIC connection states — handshake, streams, loss recovery, and close.
HTTP/3
H3Connection, QPACK header compression, and request/response handling.
Free-Threading
Running Zoomies with Python 3.14t — no GIL, true parallelism.
How the Layers Fit
| Layer | Concept | RFC |
|---|---|---|
| Packet | Encoding, decoding, header protection | RFC 9000 §17 |
| Crypto | TLS 1.3 handshake, key derivation | RFC 9001 |
| Stream | Multiplexed, ordered byte streams | RFC 9000 §2 |
| Connection | State machine, loss recovery, congestion control | RFC 9000, 9002 |
| HTTP/3 | QPACK, request/response, server push | RFC 9114 |
Tip
New to QUIC? Start with Sans-I/O to understand how Zoomies separates protocol logic from I/O, then read Connection Lifecycle for the full state machine.