| Latest release | v2.2.0 · 2026-10-19 |
|---|---|
| Release | github.com/AzmxAI/maqpna-releases/releases/tag/v2.2.0 |
| Checksums | checksums.txt · signature: bundle, .sig + .pem |
| Current stable | github.com/AzmxAI/maqpna-releases/releases/latest |
| Mirror | https://dl.maqpna.com · SHA256SUMS · stable.txt |
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
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 -- --mirrorWindows (PowerShell)
irm https://maqpna.com/install.ps1 | iexPackage managers
| Platform | Command |
|---|---|
| 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-maqpnascoop install maqpna/maqpna |
| Homebrew cask (macOS): MAQPNA Desk | brew install --cask azmxai/maqpna/maqpna-desk |
| winget (Windows): MAQPNA Desk | winget 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.debsudo 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.apksudo 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).
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.
macOS 13 files
Apple silicon (arm64), Intel (amd64) and universal CLIs; gateway and identity for local development.
Windows 10 files
CLIs for amd64 and arm64; gateway and identity for local development.
| Binary | Architecture | Download | Verify | Mirror | Size |
|---|---|---|---|---|---|
maqpna | amd64 (x86-64) | maqpna_windows_amd64.exe | signature | mirror sha256 | |
maqpna | arm64 | maqpna_windows_arm64.exe | signature | mirror sha256 | |
maqpna-install | amd64 (x86-64) | maqpna-install_windows_amd64.exe | signature | mirror sha256 | |
maqpna-install | arm64 | maqpna-install_windows_arm64.exe | signature | mirror sha256 | |
maqpna-sovereign | amd64 (x86-64) | maqpna-sovereign_windows_amd64.exe | signature | mirror sha256 | 10.0 MiB |
maqpna-sovereign | arm64 | maqpna-sovereign_windows_arm64.exe | signature | mirror sha256 | 9.1 MiB |
maqpna-gateway | amd64 (x86-64) | maqpna-gateway_windows_amd64.exe | signature | mirror sha256 | |
maqpna-gateway | arm64 | maqpna-gateway_windows_arm64.exe | signature | mirror sha256 | 24.6 MiB |
maqpna-identity | amd64 (x86-64) | maqpna-identity_windows_amd64.exe | signature | mirror sha256 | |
maqpna-identity | arm64 | maqpna-identity_windows_arm64.exe | signature | mirror sha256 |
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.
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.
Verify downloads
Checksum
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 --checkcurl -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 --checkInvoke-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 # TrueOn 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:
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.comchecksums.txt lists every release asset and is signed the same way:
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.txtBuild provenance and SBOMs
Archives and packages carry SLSA build provenance attestations generated by GitHub Actions. Check one with the GitHub CLI:
gh attestation verify maqpna_2.2.0_linux_amd64.tar.gz --owner AzmxAIEvery 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.
| Image | Platforms | Digest |
|---|---|---|
ghcr.io/azmxai/maqpna/maqpna-operator:2.2.0 | linux/amd64, linux/arm64 | 533de9d14295 |
ghcr.io/azmxai/maqpna/maqpna-gateway:2.2.0 | linux/amd64, linux/arm64 | 449d613470e1 |
ghcr.io/azmxai/maqpna/maqpna-identity:2.2.0 | linux/amd64, linux/arm64 | 2ab66aa92e7c |
ghcr.io/azmxai/maqpna/maqpna-attest:2.2.0 | linux/amd64, linux/arm64 | 71bbbca5edc4 |
ghcr.io/azmxai/maqpna/maqpna-attest-agent:2.2.0 | linux/amd64, linux/arm64 | 956961941561 |
ghcr.io/azmxai/maqpna/maqpna-exec:2.2.0 | linux/amd64, linux/arm64 | 96e8eb80838c |
ghcr.io/azmxai/maqpna/maqpna-egress-relay:2.2.0 | linux/amd64, linux/arm64 | 990d3bc920b4 |
ghcr.io/azmxai/maqpna/maqpna-browser:2.2.0 | linux/amd64, linux/arm64 | 1257187d46a9 |
ghcr.io/azmxai/maqpna/maqpna-code-interpreter:2.2.0 | linux/amd64, linux/arm64 | 5333ff9d92d6 |
ghcr.io/azmxai/maqpna/maqpna-cli:2.2.0 | linux/amd64, linux/arm64 | 27058eb96653 |
ghcr.io/azmxai/maqpna/mcp-echo:2.2.0 | linux/amd64, linux/arm64 | 7a7bb2340a58 |
Pin images by digest in production. Verify the signature and the SBOM attestation:
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.comHelm chart
The chart is published as an OCI artifact. The values-sovereign-eu.yaml profile ships inside the chart.
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.yamlPlatform 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:
xattr -d com.apple.quarantine ./maqpna
chmod +x ./maqpnaOlder releases
| Version | Date | Files |
|---|---|---|
| v2.1.0 | 2026-10-18 | release checksums.txt maqpna linux/amd64 mirror |
| v2.0.0 | 2026-10-18 | release checksums.txt maqpna linux/amd64 mirror |
| v0.1.1 | 2026-10-02 | release checksums.txt maqpna linux/amd64 mirror |
| v0.1.0 | 2026-10-02 | release checksums.txt maqpna linux/amd64 mirror |
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.