Installation

klaridian is a single CLI, published on every major channel. Each channel delivers the same generator, so pick whichever fits your toolchain.

npm / npx (Node.js)

Because klaridian is a generator you typically run a handful of times per project, the lightest option is npx — it runs the latest version without installing anything:

npx klaridian generate --spec ./api.yaml --out ./my-server --plugin otel

If you reach for it often, install the klaridian command globally instead:

npm install -g klaridian

Both run on Node.js. If you'd rather not depend on Node, use the PyPI or Homebrew channels below — they ship a self-contained native binary.

PyPI (native binary, no Node.js)

pip install klaridian

uv and pipx work too:

uv tool install klaridian
pipx install klaridian

This package ships a prebuilt native binary — no Node.js, no virtualenv, nothing to compile. It's the same CLI published to npm, compiled to a standalone executable and distributed as a platform-specific wheel (the pattern ruff and uv use).

Homebrew (macOS and Linux, native binary)

brew tap klaridian/klaridian
brew install klaridian

The tap registers klaridian's formula repository once; after that, brew install klaridian (and later brew upgrade klaridian) works by short name. The formula downloads the prebuilt binary from the GitHub Release — it doesn't depend on Node.js and doesn't build from source, so the install is instant.

Direct binary download

Every GitHub Release attaches one bare binary per platform. Download the one for your system, mark it executable, and run it:

curl -fsSL -o klaridian \
  https://github.com/klaridian/klaridian/releases/latest/download/klaridian-darwin-arm64
chmod +x klaridian
./klaridian --version

Swap the asset name for your platform:

Which channel should I pick?

• Already on Node.js? Run it with npx, or install globally with npm.
• Want a zero-dependency binary in a Python or mixed toolchain? Use PyPI.
• On macOS or Linux and managing tools with Homebrew? Use Homebrew.
• Pinning a specific version in CI, or air-gapped? Use the direct binary download.

The PyPI, Homebrew, and direct-download binaries are compiled with bun --compile and produce byte-identical output to the Node build, so the generated servers are the same whichever channel you install from.

Verify the install

klaridian --version

Next steps

• Getting started — generate your first server
• Curating the tool surface
• CLI reference — every flag