Install

Linux is the primary validated target. Windows is a preview target. Check Requirements before installing.

AppImage

The shortest path on Linux.

curl -Lo archductor.AppImage \
  https://github.com/perceo-ai/conductor-arch/releases/latest/download/archductor-x86_64.AppImage
chmod +x archductor.AppImage
sudo mv archductor.AppImage /usr/local/bin/archductor

Run it:

archductor

With no arguments the AppImage opens the GTK app. With arguments it forwards to the command-line interface.

Package managers

brew tap perceo-ai/tap
brew install archductor

paru -S archductor

nix run github:perceo-ai/conductor-arch#archductor -- doctor

Flatpak/Flathub packaging uses app ID ai.perceo.Archductor and remains experimental until the sandbox and screenshots pass Flathub review.

Build from source

Install GTK4/libadwaita and Rust first.

sudo apt update
sudo apt install git gh sqlite3 openssh-client pkg-config libgtk-4-dev libadwaita-1-dev

sudo dnf install git gh sqlite openssh-clients pkgconf-pkg-config gtk4-devel libadwaita-devel

sudo pacman -S --needed git github-cli sqlite openssh pkgconf gtk4 libadwaita

curl https://sh.rustup.rs -sSf | sh

Then build and run:

git clone https://github.com/perceo-ai/conductor-arch
cd conductor-arch
cargo build --workspace --release --locked
./target/release/archductor-gtk

Short make targets are available:

make gtk
make cli
make build
make build-release
make check

Development make launch targets are branch-scoped. make dev, make gtk, make cli, and make archcar set separate XDG config/data/state/cache directories from the current branch, so multiple checkouts can run side by side while dogfooding. Run make dev-env to print the active paths.

Optional install to PATH:

sudo install -Dm755 target/release/archductor /usr/local/bin/archductor
sudo install -Dm755 target/release/archductor-gtk /usr/local/bin/archductor-gtk

Windows preview

Tagged releases build archductor-<version>-windows-x86_64.zip. Extract the whole directory so the GTK DLLs and data directories stay beside archductor-gtk.exe, then launch that executable.

winget install --id Git.Git --id GitHub.cli

Agent CLIs remain optional. For source builds, install the MSYS2 UCRT64 GCC, pkgconf, GTK4, and libadwaita packages, then build the x86_64-pc-windows-gnu target. The CI workflow is the canonical build recipe.

Verify the download

Public release artifacts ship with SHA256SUMS. Verify checksums before installing, and verify provenance or attestations when the release includes them.

sha256sum -c SHA256SUMS
gh release view --repo perceo-ai/conductor-arch --web

Get started

Guides

Reference

AppImage

Package managers

Build from source

Windows preview

Verify the download

​AppImage

​Package managers

​Build from source

​Windows preview

​Verify the download

AppImage

Package managers

Build from source

Windows preview

Verify the download