A fast, embeddable time-series database in Zig.

• Local-first, single binary
• Crash-safe WAL → columnar TS segments
• Simple query layer (sydraQL)

zig build -Doptimize=ReleaseSafe
./zig-out/bin/sydradb            # serve using sydradb.toml
curl -XPOST localhost:8080/api/v1/ingest --data-binary $'{"series":"weather.room1","ts":1694300000,"value":24.2}\n'

# Allocator modes
zig build                                # default: mimalloc global allocator
zig build -Dallocator-mode=default       # use Zig GPA fallback
zig build -Dallocator-mode=small_pool    # use slab allocator tuned for small writes

If you use Nix, this repo includes a flake that pins Zig and provides a dev shell:

# Start a shell with the pinned Zig
nix develop

# Build the package (installs to ./result)
nix build
./result/bin/sydradb serve

Notes

• The flake integrates mitchellh/zig-overlay and prefers Zig 0.15.1. With a flake.lock committed, Zig is fully pinned and consistent for all contributors.
• To (re)pin: nix flake lock --update-input nixpkgs --update-input zig-overlay then commit the updated flake.lock.

This repository includes an .envrc that loads the pinned Nix dev shell.

1. Install direnv and nix-direnv
   • Nix: nix profile install nixpkgs#direnv nixpkgs#nix-direnv
   • Homebrew: brew install direnv
2. Hook direnv in your shell (e.g., zsh): add eval "$(direnv hook zsh)" to your shell rc.
3. Ensure nix-direnv is sourced by direnv (recommended):
   • Create ~/.config/direnv/direnvrc with: source "$HOME/.nix-profile/share/nix-direnv/direnvrc" (or equivalent for your profile).
4. In this repo run: direnv allow.

From now on, entering the directory will auto‑activate the correct toolchain.

Pre-alpha. Expect dragons.

Apache-2.0

./zig-out/bin/sydradb             # serve (HTTP): /api/v1/ingest, /api/v1/query/range, /metrics
./zig-out/bin/sydradb ingest      # read NDJSON from stdin into local WAL
./zig-out/bin/sydradb query <series_id> <start_ts> <end_ts>
./zig-out/bin/sydradb compact     # merge small→large segments (v2 stub)
./zig-out/bin/sydradb snapshot <dst_dir>
./zig-out/bin/sydradb restore  <src_dir>
./zig-out/bin/sydradb stats       # print simple counters

Config: sydradb.toml

data_dir = "./data"
http_port = 8080
fsync = "interval"  # always|interval|none
flush_interval_ms = 2000
memtable_max_bytes = 8388608
mem_limit_bytes = 268435456
auth_token = ""  # set non-empty to require Bearer auth on /api/*
enable_influx = false
enable_prom = true
# Per-namespace TTL
retention.weather = 30