21 small libraries, in three layers.
Every library is its own Go module under github.com/ciranda-dev, with its own docs, a compiled example, its API and its limits. They fit together, but none of them needs the whole stack. All of them are version 0.1.0, beta and experimental, and need Go 1.26 or newer.
How they fit together
- Data: kolo-id gives a peer its key. kolo-log keeps a signed, append-only log, kolo-store keeps it on disk, kolo-kv reads it as a key-value store, kolo-sync copies it to other peers, and kolo-codec encodes every message. kolo-blobs keeps encrypted files, and kolo-files adds names, folders and versions on top.
- Network: kolo-dht and kolo-swarm find the peers on a topic and connect to them over kolo-transport and kolo-secure. kolo-relay helps two peers that cannot reach each other, only if you turn it on. kolo-invite lets a member bring someone into a group with an invite code. kolo-moq publishes live tracks and subscribes to them over those connections, and a relay shares one subscription among many subscribers. kolo-media adds a catalog, a clock and playout for encoded audio and video frames.
- Servers you run: kolo-node runs the bootstrap server that new peers join through, and kolo-pin runs a pinning peer that stores logs it cannot read.
Data
Keys, encoding, a signed log, and the pieces that store, read and copy it.
- kolo-idPeer identity. Ed25519 keys and short IDs, a 24-word recovery phrase and device certificates.beta
- kolo-codecCompact binary encoding for messages.beta
- kolo-logSigned append-only log with Merkle proofs, after RFC 9162.beta
- kolo-storeLocal storage for logs and keys, on Pebble.beta
- kolo-blobsEncrypted, content-addressed file storage, read in any range.beta
- kolo-filesEncrypted folders, names and versions on top of kolo-blobs.beta
- kolo-syncCopies a log from one peer to another. Pull only.beta
- kolo-kvA key-value store on a log, with one writer.beta
- kolo-braidThe signed logs of several members merged into one deterministic order.beta
Network
Finding peers by topic, inviting them into a group, talking to them over an encrypted channel, and sending live tracks of data or media.
- kolo-transportConnections between peers, direct when possible.beta
- kolo-secureTLS 1.3 channel tied to the peer key.beta
- kolo-dhtFind peers by topic, with no server.beta
- kolo-swarmJoin a topic and get connected peers.beta
- kolo-relayAn optional relay for peers with no direct path.beta
- kolo-inviteInvite codes for a group or a new device: create one, join with it, approve or deny.beta
- kolo-moqPublish, subscribe to and relay live tracks, with MoQ Transport draft 22.beta
- kolo-mediaA catalog, a clock, playout and A/V sync for audio and video frames over kolo-moq.beta
- kolo-audioAudio devices, playback, resampling, mixing and Opus, with no cgo.beta
- kolo-videoCamera capture, I420 frames, VP8 and VP9, and optional H.264 from the operating system.beta
Servers you run
The bootstrap node of a network of your own, and a pinning peer that keeps encrypted logs available. On your machines, not ours. By default the examples use the public entry nodes that Ciranda runs.
A library that has no tagged release yet says so here and in the docs. The 21 are the number today; this page grows with the stack. Two more libraries are planned, with no code yet, as set out in the roadmap in the docs: kolo-gossip, which spreads small messages to many members of a group, and kolo-mls, which adds end-to-end encryption for groups with the MLS standard.