Skip to content
Ardent

Getting started

Installation

Section titled “Installation”

Ardent can be installed from several sources. Pick the one you’re most familiar with.

Winget

Section titled “Winget”

Microsoft ships Winget with Windows 11, Windows 10 (version 1809 and later), and Windows Server 2025. That makes it the ideal candidate to install Ardent on Windows.

Terminal window
winget install --id idleberg.ardent

Scoop

Section titled “Scoop”

Scoop is a third-party package manager for Windows. Ardent can be installed after adding the official NSIS bucket.

Terminal window
# One-time operation: add bucket
scoop bucket add nsis https://github.com/NSIS-Dev/scoop-nsis


# Install
scoop install nsis/ardent

Homebrew

Section titled “Homebrew”

The popular package manager Homebrew for macOS and Linux provides Ardent through the developer’s tap.

Terminal window
brew install idleberg/asahi/ardent

Cargo

Section titled “Cargo”

Cargo is the package manager and build system for the Rust programming language. If you’re at home in that ecosystem, you might want to use it to install Ardent.

Terminal window
cargo install ardent

Nix

Section titled “Nix”

There is no official Nix package for Ardent yet, but you may install Ardent from the repository’s flake.

Terminal window
nix profile install github:idleberg/ardent

Docker

Section titled “Docker”

Use Docker to install or run Ardent in an isolated container.

Terminal window
docker run idleberg/ardent

Pkgx

Section titled “Pkgx”

Pkgx offers an elegant way to try Ardent without installing it. If you want to keep it, you can install it using pkgm.

Terminal window
# Run once
pkgx ardent


# Install
pkgm install ardent

Mise

Section titled “Mise”

Mise-en-place is a tool that manages dev tools, env vars, and tasks per project. With mise-ardent installed, you can add the formatter to your local project.

Terminal window
# One-time operation: install plugin
mise plugin install ardent https://github.com/idleberg/mise-ardent


# Install ardent in your project
mise use ardent

Build from source

Section titled “Build from source”
Terminal window
# Clone the repository
git clone https://github.com/idleberg/ardent.git
cd ardent


# Setup tooling
mise install


# Build
mise run build

CI/CD

Section titled “CI/CD”

To run formatting checks in a GitHub workflow, install the ardent-check action. For more complex operations in your pipeline, you may use setup-ardent instead.