> ## Documentation Index
> Fetch the complete documentation index at: https://docs.snakream.tonbo.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Quick Start

> Use curl against a public Snakream cluster to create a bucket, append data, and subscribe with SSE.

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

## Create a bucket and a stream

```bash theme={null}
curl -X PUT https://stream.tonbo.dev/ds/demo
curl -X PUT https://stream.tonbo.dev/ds/demo/hello
```

## Append data

```bash theme={null}
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

```bash theme={null}
curl 'https://stream.tonbo.dev/ds/demo/hello?offset=-1'
```

## Subscribe for live updates

Open a second terminal and start an SSE subscription:

```bash theme={null}
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.

## Read more

* [API overview](/api/overview) — all HTTP routes and request patterns
* [Streams](/concepts/streams) — the core stream abstraction and lifecycle
* [Architecture](/architecture) — how the cluster works under the hood