> ## Documentation Index
> Fetch the complete documentation index at: https://docs.perceo.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Install

> AppImage, package managers, Windows preview, and source builds.

Linux is the primary validated target. Windows is a preview target. Check
[Requirements](/archductor/requirements) before installing.

## AppImage

The shortest path on Linux.

```bash theme={"dark"}
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:

```bash theme={"dark"}
archductor
```

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

## Package managers

<CodeGroup>
  ```bash Homebrew theme={"dark"}
  brew tap perceo-ai/tap
  brew install archductor
  ```

  ```bash Arch (AUR) theme={"dark"}
  paru -S archductor
  ```

  ```bash Nix theme={"dark"}
  nix run github:perceo-ai/conductor-arch#archductor -- doctor
  ```
</CodeGroup>

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

## Build from source

Install GTK4/libadwaita and Rust first.

<CodeGroup>
  ```bash Ubuntu / Debian theme={"dark"}
  sudo apt update
  sudo apt install git gh sqlite3 openssh-client pkg-config libgtk-4-dev libadwaita-1-dev
  ```

  ```bash Fedora theme={"dark"}
  sudo dnf install git gh sqlite openssh-clients pkgconf-pkg-config gtk4-devel libadwaita-devel
  ```

  ```bash Arch Linux theme={"dark"}
  sudo pacman -S --needed git github-cli sqlite openssh pkgconf gtk4 libadwaita
  ```

  ```bash Rust theme={"dark"}
  curl https://sh.rustup.rs -sSf | sh
  ```
</CodeGroup>

Then build and run:

```bash theme={"dark"}
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:

```bash theme={"dark"}
make gtk
make cli
make build
make build-release
make check
```

<Tip>
  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.
</Tip>

Optional install to `PATH`:

```bash theme={"dark"}
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.

```powershell theme={"dark"}
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.

```bash theme={"dark"}
sha256sum -c SHA256SUMS
gh release view --repo perceo-ai/conductor-arch --web
```