# Install Lux

Get Lux running on your machine in under a minute.

## With Nix Recommended

The easiest way to run Lux. One command, zero dependencies. Works on Linux and macOS.

    nix run git+https://git.qrty.ink/blu/lux

Don't have Nix? Install it with: `curl -L https://nixos.org/nix/install | sh`

### Verify Installation

    lux --version
    # Lux 0.1.0

## From Source

Build Lux from source using Cargo. Requires Rust toolchain.

    git clone https://git.qrty.ink/blu/lux
    cd lux
    cargo build --release

The binary will be at `./target/release/lux`. Add it to your PATH:

    export PATH="$PWD/target/release:$PATH"

### Verify Installation

    ./target/release/lux --version
    # Lux 0.1.0

## Development with Nix

Enter a development shell with all dependencies available.

    git clone https://git.qrty.ink/blu/lux
    cd lux
    nix develop

Inside the shell, you can run all development commands:

    cargo build    # Build
    cargo test     # Run tests
    cargo run      # Run interpreter

## Next Steps

Take the Tour Browse Examples Read the Docs