Home

TinyRaven

Open-source, self-hosted, drop-in alternative to Tinybird — a single Go binary (tinyraven) in front of stock OSS ClickHouse. Same API: point existing Tinybird client code at TinyRaven by changing one host variable.

Model: ScyllaDB → Cassandra. Same surface, leaner internals, Apache 2.0.

Start here

• Install — brew, apt/dnf, go install, Docker
• CLI — the tinyraven commands
• API — HTTP endpoints (Tinybird-compatible)
• Architecture — how a request flows, the three stores
• Subsystems — one line per Go package
• Deploy — Compose, Helm, CloudFormation

In one breath

You write .datasource and .pipe files (Tinybird's exact format), commit them to git, and run tinyraven deploy. Events POST to /v0/events; published pipes serve at /v0/pipes/{name}.json. ClickHouse holds the data, Redis holds the metadata + cache, git is the source of truth.

Status: pre-alpha. This wiki is generated from the codebase knowledge graph, then hand-edited.