Krelvan
Download
RegistryDownload

Krelvan 0.1.2 · public beta

Run Krelvan on infrastructure you control.

Choose the same version through npm, a container image, or the exact npm tarball. The tarball is the manual release artifact, so its GitHub download count remains visible without changing what customers receive.

Fastest trial

npm

Requires Node.js 22 or newer. The explicit version prevents a future release from changing an installation you already reviewed.

npx krelvan@0.1.2
Inspect on npm

Production path

Container

Download the release compose file and start the immutable image. It binds to your machine only and keeps data in a persistent volume.

curl -LO https://github.com/sreenathmmenon/krelvan/releases/download/v0.1.2/docker-compose.release.yml
docker compose -f docker-compose.release.yml up -d

After you start it

Your first five minutes

  1. The first npm start installs and builds the web app, so it can take a few minutes. Later starts reuse that build.
  2. Open http://localhost:3100. Copy the one-time setup token printed in the terminal and create the admin account for this installation.
  3. Open Settings → Model & secrets. Connect a hosted provider, an OpenAI-compatible endpoint, or local Ollama.
  4. Return to the Dashboard, describe an outcome, review the compiled plan, and choose Run now.
  5. Your result appears in Inbox; its signed timeline and downloadable record are available from Runs.

No krelvan.com account is created. Your admin credential, agents, model configuration, and records belong only to your self-hosted installation.

The npm launcher stores persistent data in ~/.krelvan. Ctrl-C stops it; run the same command again to restart. Back up that data directory before upgrades.

What is counted

npm reports package downloads. GitHub reports downloads of uploaded release assets such as the tarball above. Container pulls are reported by the container registry. These are channel events—not unique customers—and Krelvan never combines them into a misleading user count.

Cloning the source repository or downloading an automatically generated source archive is not treated as a product download. For a countable manual install, use the uploaded release tarball.

Want to review the source first? Open the repository · Read the FAQ