Welcome to FloRuntime

Developer Quickstart

Get up and running in under a minute

Install Flo, start the runtime, and store your first value. Every primitive ships in one binary — no Kafka, no Redis, no separate workflow engine.

macOS

# Install via Homebrew
brew install floruntime/tap/flo

# Start the runtime
flo server start

# Store and read a value
flo kv set hello "world"
flo kv get hello

Linux

# Download and install
curl -fsSL https://get.floruntime.io | sh

# Start the runtime
flo server start

# Create a stream and append an event
flo stream create events
flo stream append events '{"type":"login","user":"alice"}'

Docker

# Pull and run
docker run -p 4222:4222 -p 9090:9090 floruntime/flo:latest

# Use the CLI from another terminal
flo kv set greeting "hello from docker"
flo kv get greeting

Primitives

Storage that bends to your workload

Four data primitives — all backed by the same Raft-replicated log, shaped to fit different access patterns.

KV Store

Hash-indexed key-value with MVCC, TTL, CAS, and prefix scans.

Streams

Partitioned append-only logs with consumer groups and exactly-once delivery.

Queues

Priority queues with lease delivery, dead-letter, and visibility timeouts.

Time-Series

Columnar storage with InfluxDB line-protocol ingest and FloQL queries.

Orchestration

Build agents and pipelines on the same runtime

Durable execution, multi-step workflows, and real-time stream processing — no separate cluster needed.

Actions & Workers

Durable execution of external logic. Automatic retries, timeouts, and dead-letter handling. Workers poll for invocations and report results.

Workflows

Multi-step orchestration defined in YAML. Signals, timers, circuit breakers, and full state replay.

Stream Processing

Stateful pipelines with windowing, watermarks, checkpointing, and WASM operators. Sub-millisecond local hops.

Architecture

Thread-per-shard, single Raft log per partition, hot-warm-cold storage tiering. Designed for predictable tail latency.

Client SDKs

Talk to Flo from any language

Native clients with the full TCP wire protocol. Drop-in Redis compatibility for KV. RESP, HTTP, and WebSocket transports.

GoGo SDKPyPython SDKJSJavaScript SDKZigZig SDK

Ready to deploy?

Run a single node, a 3-node Raft cluster, or scale across regions.

Install FloCluster guide →