MAQPNA

Download · v2.2.0

Download MAQPNA

Command-line tools for Linux, macOS and Windows, server binaries, Linux packages, multi-arch container images and the Helm chart. Every file has a SHA256 checksum, a cosign keyless signature and an SBOM, built reproducibly from the tagged source.

curl -fsSL https://maqpna.com/install.sh | sh

Quick install

The install scripts download the CLIs (maqpna, its lifecycle plugin maqpna-install for install, upgrade, rollback, uninstall and preflight, and maqpna-sovereign) for your platform from the GitHub release, check the SHA256 against the release's checksums.txt and — if cosign is installed — the signature, and install them to /usr/local/bin (or ~/.local/bin) or %LOCALAPPDATA%\Programs\maqpna\bin.

Linux and macOS

sh
curl -fsSL https://maqpna.com/install.sh | sh
# a specific version, one binary, require a cosign signature:
curl -fsSL https://maqpna.com/install.sh | sh -s -- --version v2.2.0 --bin maqpna --cosign
# from the dl.maqpna.com mirror instead of GitHub:
curl -fsSL https://maqpna.com/install.sh | sh -s -- --mirror

Windows (PowerShell)

PowerShell
irm https://maqpna.com/install.ps1 | iex

Package managers

PlatformCommand
Homebrew (macOS, Linux)brew install azmxai/maqpna/maqpna
winget (Windows)winget install MAQPNA.maqpna
Scoop (Windows)scoop bucket add maqpna https://github.com/AzmxAI/scoop-maqpna
scoop install maqpna/maqpna
Homebrew cask (macOS): MAQPNA Deskbrew install --cask azmxai/maqpna/maqpna-desk
winget (Windows): MAQPNA Deskwinget install MAQPNA.Desk
Debian, Ubuntu (.deb)curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_2.2.0_linux_amd64.deb -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna-install_2.2.0_linux_amd64.deb
sudo apt install ./maqpna_2.2.0_linux_amd64.deb ./maqpna-install_2.2.0_linux_amd64.deb
RHEL, Fedora, SUSE (.rpm)sudo dnf install https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_2.2.0_linux_amd64.rpm https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna-install_2.2.0_linux_amd64.rpm
Alpine (.apk)curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_2.2.0_linux_amd64.apk -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna-install_2.2.0_linux_amd64.apk
sudo apk add --allow-untrusted ./maqpna_2.2.0_linux_amd64.apk ./maqpna-install_2.2.0_linux_amd64.apk

The Homebrew tap (AzmxAI/homebrew-maqpna) serves the formula from the first public release. The Scoop bucket (AzmxAI/scoop-maqpna), the winget package and the signed apt / yum repositories are planned and open later. Until then use the install scripts, the packages above or the binaries below. Package files for other architectures are listed under Linux packages.

Desktop app

MAQPNA Desk puts the approvals inbox on your desktop: when an agent's tool call is held for approval you get a native notification, see what the agent wants to do and which policy rule asked, and approve or deny it under your own identity. It also starts and stops a local MAQPNA (maqpna dev up) and follows the live timeline of the agent you are developing. Each app carries the maqpna CLI it drives (the Linux .deb and .rpm depend on the maqpna package instead). Guide: docs/desktop.md.

macOS

macOS 13 or later, Apple silicon and Intel (universal). Signed with an Apple Developer ID and notarized.

brew install --cask azmxai/maqpna/maqpna-desk

Windows

Windows 10 and 11, per-user installer (no administrator needed) or portable zip. Authenticode-signed. Uses WebView2.

winget install MAQPNA.Desk

Linux

amd64 and arm64, WebKitGTK 4.1 (Ubuntu 22.04+, Debian 12+, Fedora). The packages need the maqpna package; the .tar.gz carries the CLI.

arm64 and every other file: all desktop files.

Desktop app files 12 files

Verify them like every other release file: the digest is in checksums.txt and each file has a cosign signature bundle (Verify downloads).

FilePlatformVerifyMirrorSize
MAQPNA-Desk_2.2.0_macos_universal.dmgmacOS universal (arm64 and amd64), disk image46.8 MiB
MAQPNA-Desk_2.2.0_macos_universal.zipmacOS universal (arm64 and amd64), zip40.6 MiB
maqpna-desktop_2.2.0_windows_amd64_setup.exeWindows amd64 (x86-64), installer17.2 MiB
maqpna-desktop_2.2.0_windows_amd64.zipWindows amd64 (x86-64), portable zip23.1 MiB
maqpna-desktop_2.2.0_windows_arm64_setup.exeWindows arm64, installer15.1 MiB
maqpna-desktop_2.2.0_windows_arm64.zipWindows arm64, portable zip20.1 MiB
maqpna-desktop_2.2.0_linux_amd64.debLinux amd64 (x86-64), .deb2.6 MiB
maqpna-desktop_2.2.0_linux_amd64.rpmLinux amd64 (x86-64), .rpm2.7 MiB
maqpna-desktop_2.2.0_linux_amd64.tar.gzLinux amd64 (x86-64), .tar.gz23.1 MiB
maqpna-desktop_2.2.0_linux_arm64.debLinux arm64, .deb2.4 MiB
maqpna-desktop_2.2.0_linux_arm64.rpmLinux arm64, .rpm2.5 MiB
maqpna-desktop_2.2.0_linux_arm64.tar.gzLinux arm64, .tar.gz20.5 MiB

Binaries

Every file is a GitHub release asset: https://github.com/AzmxAI/maqpna-releases/releases/download/<version>/<binary>_<os>_<arch> (.exe on Windows), with its cosign signature bundle next to it as <file>.sigstore.json and its digest in the release's checksums.txt. The mirror at https://dl.maqpna.com serves the same files in the dl.k8s.io layout, https://dl.maqpna.com/<version>/bin/<os>/<arch>/<binary>, each with a .sha256 (the hex digest) and a .sigstore.json. All binaries are static (CGO_ENABLED=0).

Linux 26 files

CLIs for amd64, arm64, ppc64le and s390x; servers for amd64 and arm64.

BinaryArchitectureDownloadVerifyMirrorSize
maqpnaamd64 (x86-64)maqpna_linux_amd64
maqpnaarm64maqpna_linux_arm64
maqpnappc64lemaqpna_linux_ppc64le
maqpnas390xmaqpna_linux_s390x
maqpna-installamd64 (x86-64)maqpna-install_linux_amd64
maqpna-installarm64maqpna-install_linux_arm64
maqpna-installppc64lemaqpna-install_linux_ppc64le
maqpna-installs390xmaqpna-install_linux_s390x
maqpna-sovereignamd64 (x86-64)maqpna-sovereign_linux_amd649.8 MiB
maqpna-sovereignarm64maqpna-sovereign_linux_arm649.1 MiB
maqpna-sovereignppc64lemaqpna-sovereign_linux_ppc64le9.6 MiB
maqpna-sovereigns390xmaqpna-sovereign_linux_s390x10.1 MiB
maqpna-gatewayamd64 (x86-64)maqpna-gateway_linux_amd64
maqpna-gatewayarm64maqpna-gateway_linux_arm6424.3 MiB
maqpna-identityamd64 (x86-64)maqpna-identity_linux_amd64
maqpna-identityarm64maqpna-identity_linux_arm64
maqpna-operatoramd64 (x86-64)maqpna-operator_linux_amd64
maqpna-operatorarm64maqpna-operator_linux_arm64
maqpna-attestamd64 (x86-64)maqpna-attest_linux_amd6411.3 MiB
maqpna-attestarm64maqpna-attest_linux_arm6410.6 MiB
maqpna-attest-agentamd64 (x86-64)maqpna-attest-agent_linux_amd647.2 MiB
maqpna-attest-agentarm64maqpna-attest-agent_linux_arm646.6 MiB
maqpna-execamd64 (x86-64)maqpna-exec_linux_amd646.1 MiB
maqpna-execarm64maqpna-exec_linux_arm645.6 MiB
maqpna-egress-relayamd64 (x86-64)maqpna-egress-relay_linux_amd645.3 MiB
maqpna-egress-relayarm64maqpna-egress-relay_linux_arm644.9 MiB
macOS 13 files

Apple silicon (arm64), Intel (amd64) and universal CLIs; gateway and identity for local development.

BinaryArchitectureDownloadVerifyMirrorSize
maqpnaamd64 (x86-64)maqpna_darwin_amd6470.9 MiB
maqpnaarm64maqpna_darwin_arm64
maqpnauniversal (arm64 and amd64)maqpna_darwin_universal137.0 MiB
maqpna-installamd64 (x86-64)maqpna-install_darwin_amd64
maqpna-installarm64maqpna-install_darwin_arm64
maqpna-installuniversal (arm64 and amd64)maqpna-install_darwin_universal114.2 MiB
maqpna-sovereignamd64 (x86-64)maqpna-sovereign_darwin_amd6410.0 MiB
maqpna-sovereignarm64maqpna-sovereign_darwin_arm649.3 MiB
maqpna-sovereignuniversal (arm64 and amd64)maqpna-sovereign_darwin_universal19.3 MiB
maqpna-gatewayamd64 (x86-64)maqpna-gateway_darwin_amd64
maqpna-gatewayarm64maqpna-gateway_darwin_arm64
maqpna-identityamd64 (x86-64)maqpna-identity_darwin_amd64
maqpna-identityarm64maqpna-identity_darwin_arm64
Windows 10 files

CLIs for amd64 and arm64; gateway and identity for local development.

On the mirror, binaries larger than 25 MiB are served as a .tar.gz (or .zip) of the single binary plus LICENSE and README; GitHub serves every raw binary.

Archives and SBOMs 55 files

maqpna_<version>_* holds both CLIs (used by Homebrew, Scoop and winget); the other archives hold one binary each. macOS and Windows archives are .zip, Linux .tar.gz. Every archive has an SPDX SBOM.

ArchiveVerifySBOMMirrorSize
kubectl-maqpna_2.2.0_darwin_amd64.tar.gzSPDX21.8 MiB
kubectl-maqpna_2.2.0_darwin_arm64.tar.gzSPDX19.5 MiB
kubectl-maqpna_2.2.0_linux_amd64.tar.gzSPDX20.8 MiB
kubectl-maqpna_2.2.0_linux_arm64.tar.gzSPDX18.6 MiB
kubectl-maqpna_2.2.0_windows_amd64.zipSPDX21.0 MiB
kubectl-maqpna_2.2.0_windows_arm64.zipSPDX18.3 MiB
maqpna-attest-agent_2.2.0_linux_amd64.tar.gzSPDX3.0 MiB
maqpna-attest-agent_2.2.0_linux_arm64.tar.gzSPDX2.7 MiB
maqpna-attest_2.2.0_linux_amd64.tar.gzSPDX4.2 MiB
maqpna-attest_2.2.0_linux_arm64.tar.gzSPDX3.8 MiB
maqpna-egress-relay_2.2.0_linux_amd64.tar.gzSPDX2.3 MiB
maqpna-egress-relay_2.2.0_linux_arm64.tar.gzSPDX2.0 MiB
maqpna-exec_2.2.0_linux_amd64.tar.gzSPDX2.6 MiB
maqpna-exec_2.2.0_linux_arm64.tar.gzSPDX2.4 MiB
maqpna-gateway_2.2.0_darwin_amd64.zipSPDX9.9 MiB
maqpna-gateway_2.2.0_darwin_arm64.zipSPDX9.0 MiB
maqpna-gateway_2.2.0_linux_amd64.tar.gzSPDX9.5 MiB
maqpna-gateway_2.2.0_linux_arm64.tar.gzSPDX8.6 MiB
maqpna-gateway_2.2.0_windows_amd64.zipSPDX9.7 MiB
maqpna-gateway_2.2.0_windows_arm64.zipSPDX8.5 MiB
maqpna-identity_2.2.0_darwin_amd64.zipSPDX10.2 MiB
maqpna-identity_2.2.0_darwin_arm64.zipSPDX8.9 MiB
maqpna-identity_2.2.0_linux_amd64.tar.gzSPDX9.8 MiB
maqpna-identity_2.2.0_linux_arm64.tar.gzSPDX8.6 MiB
maqpna-identity_2.2.0_windows_amd64.zipSPDX9.9 MiB
maqpna-identity_2.2.0_windows_arm64.zipSPDX8.5 MiB
maqpna-install_2.2.0_darwin_amd64.zipSPDX18.5 MiB
maqpna-install_2.2.0_darwin_arm64.zipSPDX16.5 MiB
maqpna-install_2.2.0_darwin_universal.zipSPDX35.0 MiB
maqpna-install_2.2.0_linux_amd64.tar.gzSPDX17.7 MiB
maqpna-install_2.2.0_linux_arm64.tar.gzSPDX15.7 MiB
maqpna-install_2.2.0_linux_ppc64le.tar.gzSPDX15.6 MiB
maqpna-install_2.2.0_linux_s390x.tar.gzSPDX17.0 MiB
maqpna-install_2.2.0_windows_amd64.zipSPDX17.9 MiB
maqpna-install_2.2.0_windows_arm64.zipSPDX15.5 MiB
maqpna-operator_2.2.0_linux_amd64.tar.gzSPDX13.3 MiB
maqpna-operator_2.2.0_linux_arm64.tar.gzSPDX11.8 MiB
maqpna-sovereign_2.2.0_darwin_amd64.zipSPDX3.9 MiB
maqpna-sovereign_2.2.0_darwin_arm64.zipSPDX3.5 MiB
maqpna-sovereign_2.2.0_darwin_universal.zipSPDX7.4 MiB
maqpna-sovereign_2.2.0_linux_amd64.tar.gzSPDX3.8 MiB
maqpna-sovereign_2.2.0_linux_arm64.tar.gzSPDX3.4 MiB
maqpna-sovereign_2.2.0_linux_ppc64le.tar.gzSPDX3.4 MiB
maqpna-sovereign_2.2.0_linux_s390x.tar.gzSPDX3.6 MiB
maqpna-sovereign_2.2.0_windows_amd64.zipSPDX3.8 MiB
maqpna-sovereign_2.2.0_windows_arm64.zipSPDX3.4 MiB
maqpna_2.2.0_darwin_amd64.zipSPDX25.7 MiB
maqpna_2.2.0_darwin_arm64.zipSPDX23.0 MiB
maqpna_2.2.0_darwin_universal.zipSPDX48.7 MiB
maqpna_2.2.0_linux_amd64.tar.gzSPDX24.6 MiB
maqpna_2.2.0_linux_arm64.tar.gzSPDX22.0 MiB
maqpna_2.2.0_linux_ppc64le.tar.gzSPDX21.8 MiB
maqpna_2.2.0_linux_s390x.tar.gzSPDX23.6 MiB
maqpna_2.2.0_windows_amd64.zipSPDX24.8 MiB
maqpna_2.2.0_windows_arm64.zipSPDX21.6 MiB
Linux packages 24 files

The maqpna package installs maqpna and maqpna-sovereign to /usr/bin; the maqpna-install package of the same version adds the cluster lifecycle plugin (install, upgrade, rollback, uninstall, preflight). The .deb and .rpm of maqpna recommend maqpna-install; .apk has no recommends, so add maqpna-install explicitly on Alpine.

PackageVerifyMirrorSize
maqpna_2.2.0_linux_amd64.apk25.7 MiB
maqpna_2.2.0_linux_amd64.deb24.6 MiB
maqpna_2.2.0_linux_amd64.rpm24.6 MiB
maqpna_2.2.0_linux_arm64.apk22.9 MiB
maqpna_2.2.0_linux_arm64.deb22.0 MiB
maqpna_2.2.0_linux_arm64.rpm22.0 MiB
maqpna_2.2.0_linux_ppc64le.apk22.9 MiB
maqpna_2.2.0_linux_ppc64le.deb21.9 MiB
maqpna_2.2.0_linux_ppc64le.rpm21.9 MiB
maqpna_2.2.0_linux_s390x.apk25.1 MiB
maqpna_2.2.0_linux_s390x.deb23.6 MiB
maqpna_2.2.0_linux_s390x.rpm23.6 MiB
maqpna-install_2.2.0_linux_amd64.apk18.5 MiB
maqpna-install_2.2.0_linux_amd64.deb17.7 MiB
maqpna-install_2.2.0_linux_amd64.rpm17.7 MiB
maqpna-install_2.2.0_linux_arm64.apk16.4 MiB
maqpna-install_2.2.0_linux_arm64.deb15.7 MiB
maqpna-install_2.2.0_linux_arm64.rpm15.7 MiB
maqpna-install_2.2.0_linux_ppc64le.apk16.3 MiB
maqpna-install_2.2.0_linux_ppc64le.deb15.6 MiB
maqpna-install_2.2.0_linux_ppc64le.rpm15.6 MiB
maqpna-install_2.2.0_linux_s390x.apk18.0 MiB
maqpna-install_2.2.0_linux_s390x.deb17.0 MiB
maqpna-install_2.2.0_linux_s390x.rpm17.0 MiB

Verify downloads

Checksum

Linux
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_linux_amd64
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/checksums.txt
grep ' maqpna_linux_amd64$' checksums.txt | sha256sum --check
macOS
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_darwin_arm64
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/checksums.txt
grep ' maqpna_darwin_arm64$' checksums.txt | shasum -a 256 --check
Windows (PowerShell)
Invoke-WebRequest https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_windows_amd64.exe -OutFile maqpna_windows_amd64.exe
Invoke-WebRequest https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/checksums.txt -OutFile checksums.txt
$want = ((Select-String -Path checksums.txt -Pattern ' maqpna_windows_amd64\.exe$').Line -split '\s+')[0]
(Get-FileHash .\maqpna_windows_amd64.exe -Algorithm SHA256).Hash -eq $want   # True

On the mirror every file has a .sha256 next to it (the hex digest), e.g. https://dl.maqpna.com/v2.2.0/bin/linux/amd64/maqpna.sha256; its SHA256SUMS is the release's checksums.txt.

Signature (cosign keyless)

Release files are signed in GitHub Actions with Sigstore keyless signing: the certificate binds the signature to the workflow that built and signed the release (the identity below). There is no long-lived signing key. Verify with cosign 2.x or later:

sh
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/maqpna_linux_amd64.sigstore.json
cosign verify-blob maqpna_linux_amd64 \
  --bundle maqpna_linux_amd64.sigstore.json \
  --certificate-identity-regexp '^https://github\.com/AzmxAI/azmx-ai/\.github/workflows/maqpna-signed-release\.yml@refs/.+$' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

checksums.txt lists every release asset and is signed the same way:

sh
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/checksums.txt
curl -LO https://github.com/AzmxAI/maqpna-releases/releases/download/v2.2.0/checksums.txt.sigstore.json
cosign verify-blob checksums.txt --bundle checksums.txt.sigstore.json \
  --certificate-identity-regexp '^https://github\.com/AzmxAI/azmx-ai/\.github/workflows/maqpna-signed-release\.yml@refs/.+$' \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
sha256sum --ignore-missing --check checksums.txt

Build provenance and SBOMs

Archives and packages carry SLSA build provenance attestations generated by GitHub Actions. Check one with the GitHub CLI:

sh
gh attestation verify maqpna_2.2.0_linux_amd64.tar.gz --owner AzmxAI

Every archive has an SPDX 2.3 SBOM next to it (<archive>.spdx.json); container images carry their SBOM as a signed cosign attestation.

Container images

Multi-arch images (linux/amd64, linux/arm64) are published to ghcr.io/azmxai/maqpna. The runtime images are distroless and run as UID 65532.

ImagePlatformsDigest
ghcr.io/azmxai/maqpna/maqpna-operator:2.2.0linux/amd64, linux/arm64533de9d14295
ghcr.io/azmxai/maqpna/maqpna-gateway:2.2.0linux/amd64, linux/arm64449d613470e1
ghcr.io/azmxai/maqpna/maqpna-identity:2.2.0linux/amd64, linux/arm642ab66aa92e7c
ghcr.io/azmxai/maqpna/maqpna-attest:2.2.0linux/amd64, linux/arm6471bbbca5edc4
ghcr.io/azmxai/maqpna/maqpna-attest-agent:2.2.0linux/amd64, linux/arm64956961941561
ghcr.io/azmxai/maqpna/maqpna-exec:2.2.0linux/amd64, linux/arm6496e8eb80838c
ghcr.io/azmxai/maqpna/maqpna-egress-relay:2.2.0linux/amd64, linux/arm64990d3bc920b4
ghcr.io/azmxai/maqpna/maqpna-browser:2.2.0linux/amd64, linux/arm641257187d46a9
ghcr.io/azmxai/maqpna/maqpna-code-interpreter:2.2.0linux/amd64, linux/arm645333ff9d92d6
ghcr.io/azmxai/maqpna/maqpna-cli:2.2.0linux/amd64, linux/arm6427058eb96653
ghcr.io/azmxai/maqpna/mcp-echo:2.2.0linux/amd64, linux/arm647a7bb2340a58

Pin images by digest in production. Verify the signature and the SBOM attestation:

sh
cosign verify ghcr.io/azmxai/maqpna/maqpna-gateway:2.2.0 \
  --certificate-identity https://github.com/AzmxAI/maqpna/.github/workflows/release.yml@refs/tags/v2.2.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com
cosign verify-attestation --type spdxjson ghcr.io/azmxai/maqpna/maqpna-gateway:2.2.0 \
  --certificate-identity https://github.com/AzmxAI/maqpna/.github/workflows/release.yml@refs/tags/v2.2.0 \
  --certificate-oidc-issuer https://token.actions.githubusercontent.com

Helm chart

The chart is published as an OCI artifact. The values-sovereign-eu.yaml profile ships inside the chart.

sh
helm pull oci://ghcr.io/azmxai/maqpna/charts/maqpna --version 2.2.0 --untar
helm install maqpna ./maqpna \
  --namespace maqpna-system --create-namespace \
  --set image.registry=ghcr.io/azmxai/maqpna \
  -f maqpna/values-sovereign-eu.yaml

Platform guides: Azure AKS · Amazon EKS · Google GKE · OpenShift · k3s and kind. Air-gapped clusters: see air-gapped install.

macOS notes

Release builds of the macOS binaries are code-signed with an Apple Developer ID (hardened runtime) and the .zip archives are notarized by Apple. Homebrew, the install script and curl do not set the quarantine attribute in any case. If you have an unsigned build (for example a development snapshot) and macOS refuses to open a binary downloaded with a browser, verify the checksum and signature first, then clear the attribute:

macOS
xattr -d com.apple.quarantine ./maqpna
chmod +x ./maqpna

Older releases

Every file of an older release stays on its GitHub release (github.com/AzmxAI/maqpna-releases/releases/tag/<version>) and on the mirror at https://dl.maqpna.com/<version>/… with the same layout.