Installation

Lucid Train is one self-contained binary. Once installed it runs fully offline · only OpenRouter models reach the network. Pick whichever channel suits you.

Recommended · pip wheel

The pip wheel bundles the compiled binary (the same approach ruff and uv use) · no Python build tools or Rust toolchain required:

shell
$ pip install lucid-train

Or with an isolated/managed installer:

shell
$ pipx install lucid-train
$ uv tool install lucid-train

Native install · by OS

Build & install from source (auto-installs Rust):

shell
$ curl -fsSL https://lucidtrain.com/install.sh | sh

Homebrew:

shell
$ brew install Arnab28122000/lucid-train/lucid-train

Requires the lucid-train Homebrew tap.

Cargo (needs Rust):

shell
$ cargo install lucid-train

Prebuilt binaries

Every release ships prebuilt binaries at lucidtrain.com/releases for macOS (arm64/x86_64), Linux (x86_64/aarch64), and Windows (x86_64). Fetch a prebuilt binary without compiling:

shell
$ cargo binstall lucid-train

curl | sh

The one-liner clones the repo and builds with cargo, installing Rust first if needed:

shell
$ curl -fsSL https://lucidtrain.com/install.sh | sh

Verify

shell
$ lucid-train --version

Then head to the quickstart to run your first task · no API key required for local models.