Quick Start

All you need is curl. The examples below use a public Snakream cluster at stream.tonbo.dev.

Create a bucket and a stream

curl -X PUT https://stream.tonbo.dev/ds/demo
curl -X PUT https://stream.tonbo.dev/ds/demo/hello

Append data

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/octet-stream' \
  --data-binary 'first message'

curl -X POST https://stream.tonbo.dev/ds/demo/hello \
  -H 'Content-Type: application/octet-stream' \
  --data-binary 'second message'

Read everything from the beginning

curl 'https://stream.tonbo.dev/ds/demo/hello?offset=-1'

Open a second terminal and start an SSE subscription:

curl 'https://stream.tonbo.dev/ds/demo/hello?offset=-1&live=sse'

Then go back to the first terminal and append more data. You’ll see it arrive in the SSE stream instantly.

API overview — all HTTP routes and request patterns
Streams — the core stream abstraction and lifecycle
Architecture — how the cluster works under the hood

Getting Started

Concepts

Architecture

API

Protocol Specification

Comparisons

Create a bucket and a stream

Append data

Read everything from the beginning

Read more

​Create a bucket and a stream

​Append data

​Read everything from the beginning

​Subscribe for live updates

​Read more

Create a bucket and a stream

Append data

Read everything from the beginning

Subscribe for live updates

Read more