NX AppHub CLI |

Introduction

NX AppHub CLI is a streamlined tool for building and managing AppImages in Nitrux from simple YAML recipes — fast, portable, and fully container-aware.

⚠️ Important: NX AppHub CLI primarily targets Nitrux OS, and using this utility in other distributions may or may not work. To request formal support for other distributions, open a PR regarding this use case.

For more in-depth information about NX AppHub CLI, please see the Wiki.

Requirements

• Nitrux 4.0.0 and newer.
  • ♦ Information: To use nx-apphub-cli in previous versions of Nitrux use a container.
• Python 3.10 and newer.

NX AppHub CLI requires the following utilities to function properly:

• appstream
• binutils
• file
• fuse3
• git
• libfuse2t64
• patchelf
• zstd

Installation

To install NX AppHub CLI we recommend using pipx.

Single-user

pipx install git+https://github.com/Nitrux/nx-apphub.git

System-wide

pipx install --system-site-packages git+https://github.com/Nitrux/nx-apphub.git

Usage

To use NX AppHub CLI check the commands below.

• install→ Install one or more applications.
• remove → Remove one or more installed applications.
• update → Update one or more installed applications.
• downgrade → Downgrade one or more installed applications.
• search → Search for specific applications.
• show → Show installed applications.
• build → Build an AppImage from a local YAML file.
  • --appdir-lint → Optionally debug missing shared libraries in an AppImage.
• generate → Generate YAML template from package metadata.
  • --package → Specify package name.
  • --distro → Choose the distribution from which to get metadata.
  • --release → The release of the selected distribution.
  • --arch → Specify the target architecture.
  • --output → The file name of the generated YAML file.
  • --description-output → The file name of the generated metadata file.

Examples

nx-apphub-cli install inkscape

nx-apphub-cli remove fiery

nx-apphub-cli update nano

nx-apphub-cli downgrade mc

nx-apphub-cli search nano mc fiery

nx-apphub-cli show

nx-apphub-cli build app.yml 
  ↪ (debug) nx-apphub-cli build app.yml --appdir-lint squashfs-root/

nx-apphub-cli generate \
  --package mc \
  --distro debian \
  --release testing \
  --arch amd64 \
  --components main \
  --output mc.yml

Licensing

The license for this repository and its contents is BSD-3-Clause.

Issues

If you find problems with the contents of this repository, please create an issue.

©2025 Nitrux Latinoamericana S.C.