Kagu (v0.1)

A small web framework for Roc. Router, middleware, route params, and a C++ TCP host so you can actually run it.

See docs.md for how to use it and changelog.md for what's in this release.

Setup

mkdir -p ~/roc && cd ~/roc
curl -sL -o roc.tar.gz "https://github.com/roc-lang/nightlies/releases/download/nightly-2026-July-15-c2d30e8/roc_nightly-linux_x86_64-2026-07-15-c2d30e8.tar.gz"
tar -xzf roc.tar.gz
export PATH="$HOME/roc/roc_nightly-linux_x86_64-2026-07-15-c2d30e8:$PATH"

You'll also need g++ (C++17) and ar. Linux x86_64 only.

Build the host

cd kagu_platform
./build_host.sh

Run an example

sh build_app.sh examples/quotes_app.roc
./examples/quotes_app

Then in another terminal:

curl http://localhost:8000/
curl http://localhost:8000/quotes/2
curl "http://localhost:8000/search?author=Ada"

build_app.sh runs roc build and then patch_interp.sh, which fixes a linker quirk on the x64glibc target. Details in docs.md.