ODS V3 Pre-Release: Public testing and refinement ahead of the official V3 launch. Turn your PC, Mac, or Linux box into a private AI server.
Python ai-agentsamdcomfyuidockerllama-cppllmlocal-ain8nnvidiaopen-webuiragself-hostedspeech-to-textstrix-halotext-to-speechworkflow-automation
#!/bin/bash
# ============================================================================
# ODS Installer — Packaging
# ============================================================================
# Part of: installers/lib/
# Purpose: Distro-agnostic package manager abstraction
#
# Expects: LOG_FILE, log(), warn(), error()
# Provides: detect_pkg_manager(), pkg_install(), pkg_update(), pkg_available(),
# PKG_MANAGER, DISTRO_ID, DISTRO_ID_LIKE
#
# Modder notes:
# Add new distro support by extending the case blocks below.
# Distro detection reads /etc/os-release (standard on all systemd distros).
# ============================================================================
PKG_MANAGER=""
DISTRO_ID=""
DISTRO_ID_LIKE=""
# Use sudo only when not already root (e.g. Docker containers run as root)
_SUDO=""
if [[ ${EUID:-$(id -u)} -ne 0 ]]; then
if declare -f ods_sudo >/dev/null 2>&1; then
_SUDO="ods_sudo"
else
_SUDO="sudo"
fi
fi
_pkg_run() {
if [[ -n "$_SUDO" ]]; then
"$_SUDO" "$@"
else
"$@"
fi
}
_pkg_retry() {
local max="${PKG_RETRY_ATTEMPTS:-3}"
local delay="${PKG_RETRY_DELAY:-15}"
local attempt=1 status=0
while (( attempt <= max )); do
if _pkg_run "$@"; then
return 0
else
status=$?
fi
if (( attempt >= max )); then
return "$status"
fi
warn "Package command failed (attempt ${attempt}/${max}): $*; retrying in ${delay}s"
sleep "$delay"
attempt=$(( attempt + 1 ))
done
return "$status"
}
_pkg_prepare_pacman_keyrings() {
command -v pacman-key >/dev/null 2>&1 || return 0
_pkg_run pacman-key --init 2>>"$LOG_FILE" || true
local ring
for ring in archlinux manjaro cachyos; do
if [[ -f "/usr/share/pacman/keyrings/${ring}.gpg" ]]; then
_pkg_run pacman-key --populate "$ring" 2>>"$LOG_FILE" || true
fi
done
}
_pkg_bounded_positive_int() {
local value="$1"
local default="$2"
local max="$3"
if [[ ! "$value" =~ ^[0-9]+$ ]] || (( value < 1 )); then
value="$default"
elif (( value > max )); then
value="$max"
fi
printf '%s\n' "$value"
}
_pkg_configure_zypper_ci_network() {
[[ "$PKG_MANAGER" == "zypper" ]] || return 0
[[ -n "${GITHUB_ACTIONS:-}" || -n "${CI:-}" ]] || return 0
local conf_dir="${ODS_ZYPPER_CI_CONF_DIR:-/etc/zypp/zypp.conf.d}"
local conf_file="${conf_dir}/99-ods-ci-network.conf"
local transfer_timeout connect_timeout max_silent_tries
local tmp
transfer_timeout="$(_pkg_bounded_positive_int "${ODS_ZYPPER_CI_TRANSFER_TIMEOUT:-180}" 180 180)"
connect_timeout="$(_pkg_bounded_positive_int "${ODS_ZYPPER_CI_CONNECT_TIMEOUT:-30}" 30 30)"
max_silent_tries="$(_pkg_bounded_positive_int "${ODS_ZYPPER_CI_MAX_SILENT_TRIES:-3}" 3 3)"
tmp="$(mktemp "${TMPDIR:-/tmp}/ods-zypp-ci-network.XXXXXX")" || return 0
cat >"$tmp" <<EOF
[main]
download.transfer_timeout = ${transfer_timeout}
download.connect_timeout = ${connect_timeout}
download.min_download_speed = 0
download.max_silent_tries = ${max_silent_tries}
download.max_concurrent_connections = 2
EOF
_pkg_run mkdir -p "$conf_dir" 2>>"$LOG_FILE" || {
rm -f "$tmp"
return 0
}
_pkg_run cp "$tmp" "$conf_file" 2>>"$LOG_FILE" || true
rm -f "$tmp"
}
# Detect the system's package manager from /etc/os-release
# Sets: PKG_MANAGER, DISTRO_ID, DISTRO_ID_LIKE
detect_pkg_manager() {
if [[ -f /etc/os-release ]]; then
local _saved_version="${VERSION:-}"
# shellcheck source=/dev/null
source /etc/os-release
VERSION="$_saved_version"
DISTRO_ID="${ID:-unknown}"
DISTRO_ID_LIKE="${ID_LIKE:-}"
else
DISTRO_ID="unknown"
DISTRO_ID_LIKE=""
fi
# Normalize: check ID first, then ID_LIKE for derivatives
case "$DISTRO_ID" in
ubuntu|debian|linuxmint|pop|elementary|zorin|kali|raspbian)
PKG_MANAGER="apt" ;;
fedora|rhel|centos|rocky|alma|nobara)
PKG_MANAGER="dnf" ;;
arch|cachyos|manjaro|endeavouros|garuda|artix)
PKG_MANAGER="pacman" ;;
opensuse*|sles)
PKG_MANAGER="zypper" ;;
void)
PKG_MANAGER="xbps" ;;
alpine)
PKG_MANAGER="apk" ;;
*)
# Fallback: check ID_LIKE for derivative distros
case "$DISTRO_ID_LIKE" in
*debian*|*ubuntu*) PKG_MANAGER="apt" ;;
*fedora*|*rhel*) PKG_MANAGER="dnf" ;;
*arch*) PKG_MANAGER="pacman" ;;
*suse*) PKG_MANAGER="zypper" ;;
*)
# Last resort: check what's actually installed
if command -v apt-get &>/dev/null; then
PKG_MANAGER="apt"
elif command -v dnf &>/dev/null; then
PKG_MANAGER="dnf"
elif command -v pacman &>/dev/null; then
PKG_MANAGER="pacman"
elif command -v zypper &>/dev/null; then
PKG_MANAGER="zypper"
else
PKG_MANAGER="unknown"
fi
;;
esac
;;
esac
log "Detected distro: ${DISTRO_ID} (like: ${DISTRO_ID_LIKE:-none}, pkg: ${PKG_MANAGER})"
}
# Update the package index
pkg_update() {
case "$PKG_MANAGER" in
# sudo-rs 0.2.13/use_pty can stop apt when it inherits a terminal.
# Package commands are unattended; close input before entering sudo.
apt) _pkg_run apt-get update -qq </dev/null 2>>"$LOG_FILE" ;;
dnf) _pkg_run dnf check-update -q 2>>"$LOG_FILE" || true ;; # returns 100 if updates available
pacman) _pkg_prepare_pacman_keyrings; _pkg_retry pacman -Syyu --noconfirm 2>>"$LOG_FILE" ;; # full sync+upgrade (partial -Sy is unsafe)
zypper)
_pkg_configure_zypper_ci_network
# Minimal container images may contain repository definitions but
# no usable metadata/key cache. Refresh them just like an installed
# host; --no-refresh on that initial state silently skips packages.
_pkg_retry zypper --non-interactive --gpg-auto-import-keys refresh 2>>"$LOG_FILE"
;;
xbps) _pkg_run xbps-install -S 2>>"$LOG_FILE" ;;
apk) _pkg_run apk update 2>>"$LOG_FILE" ;;
*) warn "Cannot update package index: unknown package manager '$PKG_MANAGER'" ;;
esac
}
# Install one or more packages
# Usage: pkg_install curl jq rsync
pkg_install() {
local requested=("$@")
local pkgs=()
local pkg resolved
for pkg in "${requested[@]}"; do
resolved="$(pkg_resolve "$pkg")"
# Some canonical packages intentionally expand to multiple packages.
# shellcheck disable=SC2206
pkgs+=($resolved)
done
[[ ${#pkgs[@]} -eq 0 ]] && return 0
log "Installing packages (${PKG_MANAGER}): ${pkgs[*]}"
case "$PKG_MANAGER" in
apt) _pkg_run apt-get install -y -qq "${pkgs[@]}" </dev/null 2>>"$LOG_FILE" ;;
dnf) _pkg_run dnf install -y -q "${pkgs[@]}" 2>>"$LOG_FILE" ;;
pacman) _pkg_prepare_pacman_keyrings; _pkg_retry pacman -S --noconfirm --needed "${pkgs[@]}" 2>>"$LOG_FILE" ;;
zypper)
_pkg_configure_zypper_ci_network
_pkg_retry zypper --non-interactive --gpg-auto-import-keys install -y "${pkgs[@]}" 2>>"$LOG_FILE"
;;
xbps) _pkg_run xbps-install -y "${pkgs[@]}" 2>>"$LOG_FILE" ;;
apk) _pkg_run apk add --no-progress "${pkgs[@]}" 2>>"$LOG_FILE" ;;
*) warn "Cannot install packages: unknown package manager '$PKG_MANAGER'. Install manually: ${pkgs[*]}" ; return 1 ;;
esac
}
# Check if a package is available in the repos
# Usage: if pkg_available jq; then ...
pkg_available() {
local pkg="$1"
case "$PKG_MANAGER" in
apt) apt-cache show "$pkg" &>/dev/null ;;
dnf) dnf info "$pkg" &>/dev/null ;;
pacman) pacman -Si "$pkg" &>/dev/null ;;
zypper) zypper info "$pkg" &>/dev/null ;;
xbps) xbps-query -Rs "$pkg" &>/dev/null ;;
apk) apk info -e "$pkg" &>/dev/null || apk search -q "$pkg" &>/dev/null ;;
*) return 1 ;;
esac
}
# Map a canonical package name to distro-specific name where needed
# Usage: pkg_name=$(pkg_resolve docker-compose-plugin)
pkg_resolve() {
local canonical="$1"
case "$PKG_MANAGER" in
apt)
case "$canonical" in
docker-compose-plugin) echo "docker-compose-plugin" ;;
podman-compose) echo "podman-compose" ;;
python3-pyyaml) echo "python3-yaml" ;;
python3-pip) echo "python3-pip" ;;
*) echo "$canonical" ;;
esac
;;
dnf)
case "$canonical" in
curl)
if command -v rpm &>/dev/null && rpm -q curl-minimal &>/dev/null; then
echo "curl-minimal"
else
echo "curl"
fi
;;
docker-compose-plugin) echo "docker-compose-plugin" ;;
podman-compose) echo "podman-compose" ;;
python3-pyyaml) echo "python3-pyyaml" ;;
python3-pip) echo "python3-pip" ;;
build-essential) echo "gcc gcc-c++ make" ;;
*) echo "$canonical" ;;
esac
;;
pacman)
case "$canonical" in
docker-compose-plugin) echo "docker-compose" ;;
podman-compose) echo "podman-compose" ;;
python3-pyyaml) echo "python-yaml" ;;
python3-pip) echo "python-pip" ;;
build-essential) echo "base-devel" ;;
*) echo "$canonical" ;;
esac
;;
zypper)
case "$canonical" in
docker-compose-plugin) echo "docker-compose" ;;
podman-compose) echo "docker-compose" ;;
python3-pyyaml) echo "python3-PyYAML" ;;
python3-pip) echo "python3-pip" ;;
build-essential) echo "devel_basis" ;;
*) echo "$canonical" ;;
esac
;;
xbps)
case "$canonical" in
docker-compose-plugin) echo "docker-compose" ;;
podman-compose) echo "podman-compose" ;;
python3-pyyaml) echo "python3-yaml" ;;
python3-pip) echo "python3-pip" ;;
build-essential) echo "base-devel" ;;
*) echo "$canonical" ;;
esac
;;
apk)
case "$canonical" in
docker-compose-plugin) echo "docker-cli-compose" ;;
podman-compose) echo "podman-compose" ;;
python3-pyyaml) echo "py3-yaml" ;;
python3-pip) echo "py3-pip" ;;
build-essential) echo "build-base" ;;
*) echo "$canonical" ;;
esac
;;
*)
echo "$canonical" ;;
esac
}