From public source to running graph.

Before you start: use JDK 21, Maven 3.9+, Node.js 24 and npm. The current UI package requires Node 24 even though an older source quickstart still says Node 20.19+.

1. Clone and build the release shape

   Clone https://github.com/ravenroot-ai/ravenroot.git, check out dev, then run the project’s release builder. It tests and builds the UI, verifies the 40-module Maven reactor and packages the executable JAR.

   git clone https://github.com/ravenroot-ai/ravenroot.git
   cd ravenroot
   git checkout dev
   ./ravenroot/scripts/build-release.sh

2. Launch on the loopback default

   The default bind stays on this machine. The server starts with a local-only disabled-auth warning; a non-loopback bind requires explicit authentication configuration.

   java -jar ravenroot/ravenroot-distribution/target/ravenroot.jar

3. Verify the runtime

   Open a second terminal and check health, engine status and the catalog actually installed in this deployment.

   curl --fail http://127.0.0.1:8080/health
   curl --fail http://127.0.0.1:8080/v1/status
   curl --fail http://127.0.0.1:8080/v1/node-types

4. Open the editor

   Visit http://127.0.0.1:8080, load executable GraphML and follow the catalog-backed palette. Start with Test before Run when a graph includes controlled external effects.

Proof run: 0.7.0-alpha.1 source at commit 627cdf508f9d43c504b560bfc1b3466f1b6bed99, JDK 21, 40-module build. Source availability and published 0.6.1-alpha.1 artifacts are separate release channels.