Verified local path

From source checkout to running graph.

Ravenroot does not publish a public product repository or release artifact yet. If you already have access to the current evaluation source, this is the tested path to a local JAR and editor.

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. Build the release shape

    From the root of the current evaluation checkout, run the project’s release builder. It installs and tests the UI, builds it, verifies the 28-module Maven reactor and packages the executable JAR.

    ./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: current source commit fa922825f3a3801765c483aaaaa670327497c62d, JDK 21.0.11, Node 24.19.0, 28-module build. This page is a source-evaluation path, not a public installation promise.

Next step

Learn the editor, then inspect the boundaries.

The UI guide covers authoring and execution states. The status page distinguishes current capabilities from extension seams and roadmap work.