Spaces:
Configuration error
Configuration error
| # --------------------------------------------------------------------------- | |
| # DEX Studio — System Dependencies Installer | |
| # --------------------------------------------------------------------------- | |
| # Installs all Linux/macOS system-level packages required to develop and | |
| # run DEX Studio, including the pywebview native-window backend (GTK/WebKit | |
| # on Linux, WebKit on macOS — bundled). | |
| # | |
| # Usage: | |
| # uv run poe setup-system # via poe task (recommended) | |
| # bash scripts/setup-system.sh # direct execution | |
| # | |
| # Supports: Ubuntu/Debian, Fedora/RHEL, Arch Linux, macOS (Homebrew) | |
| # --------------------------------------------------------------------------- | |
| set -euo pipefail | |
| # ── Colour helpers ────────────────────────────────────────────────────────── | |
| RED='\033[0;31m' | |
| GREEN='\033[0;32m' | |
| YELLOW='\033[1;33m' | |
| CYAN='\033[0;36m' | |
| NC='\033[0m' # No Colour | |
| info() { echo -e "${CYAN}[INFO]${NC} $*"; } | |
| ok() { echo -e "${GREEN}[OK]${NC} $*"; } | |
| warn() { echo -e "${YELLOW}[WARN]${NC} $*"; } | |
| fail() { echo -e "${RED}[FAIL]${NC} $*"; } | |
| # ── Sudo pre-check ───────────────────────────────────────────────────────── | |
| ensure_sudo() { | |
| if [[ "$OS" == "macos" ]]; then | |
| return 0 # Homebrew doesn't need sudo | |
| fi | |
| if [[ $EUID -eq 0 ]]; then | |
| return 0 # Already root | |
| fi | |
| # Not root — print the command and exit | |
| echo "" | |
| warn "This script needs root to install system packages." | |
| echo "" | |
| info "Run directly:" | |
| echo "" | |
| echo " sudo bash scripts/setup-system.sh" | |
| echo "" | |
| exit 1 | |
| } | |
| # ── Detect OS / package manager ──────────────────────────────────────────── | |
| detect_os() { | |
| if [[ "$OSTYPE" == "darwin"* ]]; then | |
| OS="macos" | |
| elif command -v apt-get &>/dev/null; then | |
| OS="debian" | |
| elif command -v dnf &>/dev/null; then | |
| OS="fedora" | |
| elif command -v pacman &>/dev/null; then | |
| OS="arch" | |
| else | |
| fail "Unsupported OS. Install the packages listed below manually." | |
| echo "" | |
| echo "Required packages:" | |
| echo " - git, curl, build tools (gcc, make)" | |
| echo " - Python 3.11+" | |
| echo " - GTK 3/4 + WebKitGTK + PyGObject (for pywebview native mode)" | |
| echo "" | |
| echo " OR skip native mode and run in browser:" | |
| echo " dex-studio --no-native" | |
| echo "" | |
| exit 1 | |
| fi | |
| } | |
| # ── Package lists per OS ─────────────────────────────────────────────────── | |
| install_debian() { | |
| info "Updating apt package index..." | |
| sudo apt-get update -qq | |
| info "Installing core build tools..." | |
| sudo apt-get install -y --no-install-recommends \ | |
| git \ | |
| curl \ | |
| ca-certificates \ | |
| build-essential \ | |
| libffi-dev \ | |
| libssl-dev \ | |
| pkg-config | |
| info "Installing GTK + WebKitGTK + PyGObject (pywebview backend)..." | |
| sudo apt-get install -y --no-install-recommends \ | |
| python3-gi \ | |
| python3-gi-cairo \ | |
| gir1.2-gtk-3.0 \ | |
| gir1.2-webkit2-4.1 \ | |
| libgirepository1.0-dev \ | |
| libcairo2-dev | |
| info "Installing additional Python development headers..." | |
| sudo apt-get install -y --no-install-recommends \ | |
| python3-dev | |
| } | |
| install_fedora() { | |
| info "Installing core build tools..." | |
| sudo dnf install -y \ | |
| git \ | |
| curl \ | |
| gcc \ | |
| gcc-c++ \ | |
| make \ | |
| libffi-devel \ | |
| openssl-devel \ | |
| pkg-config | |
| info "Installing GTK + WebKitGTK + PyGObject (pywebview backend)..." | |
| sudo dnf install -y \ | |
| python3-gobject \ | |
| gtk3 \ | |
| webkit2gtk4.1 \ | |
| gobject-introspection-devel \ | |
| cairo-gobject-devel | |
| info "Installing additional Python development headers..." | |
| sudo dnf install -y \ | |
| python3-devel | |
| } | |
| install_arch() { | |
| info "Installing core build tools..." | |
| sudo pacman -Syu --noconfirm \ | |
| git \ | |
| curl \ | |
| base-devel \ | |
| openssl \ | |
| pkgconf | |
| info "Installing GTK + WebKitGTK + PyGObject (pywebview backend)..." | |
| sudo pacman -S --noconfirm \ | |
| python-gobject \ | |
| gtk3 \ | |
| webkit2gtk-4.1 \ | |
| gobject-introspection \ | |
| cairo | |
| } | |
| install_macos() { | |
| if ! command -v brew &>/dev/null; then | |
| fail "Homebrew not found. Install from https://brew.sh" | |
| exit 1 | |
| fi | |
| info "Installing core packages via Homebrew..." | |
| brew install git curl | |
| # macOS uses native WebKit — no GTK needed | |
| # pywebview uses pyobjc (installed via pip/uv as a Python dependency) | |
| info "Installing PyObjC bridge for macOS native window..." | |
| ok "macOS uses built-in WebKit — no GTK/QT needed for pywebview" | |
| ok "pyobjc will be installed automatically via 'uv sync'" | |
| } | |
| # ── Install uv (if not present) ─────────────────────────────────────────── | |
| install_uv() { | |
| # Check as the real user, not root | |
| local real_user="${SUDO_USER:-$USER}" | |
| if command -v uv &>/dev/null; then | |
| ok "uv already installed ($(uv --version))" | |
| return 0 | |
| fi | |
| # Also check the real user's PATH (uv installs to ~/.local/bin) | |
| local user_uv="$(eval echo ~"$real_user")/.local/bin/uv" | |
| if [[ -x "$user_uv" ]]; then | |
| ok "uv already installed at $user_uv" | |
| return 0 | |
| fi | |
| info "Installing uv for user $real_user..." | |
| if [[ $EUID -eq 0 && -n "${SUDO_USER:-}" ]]; then | |
| # Running as root via sudo — install as the calling user so uv | |
| # lands in ~user/.local/bin, not /root/.local/bin | |
| sudo -u "$SUDO_USER" bash -c 'curl -LsSf https://astral.sh/uv/install.sh | sh' | |
| else | |
| curl -LsSf https://astral.sh/uv/install.sh | sh | |
| fi | |
| ok "uv installed" | |
| } | |
| # ── Python deps ──────────────────────────────────────────────────────────── | |
| install_python_deps() { | |
| echo "" | |
| local real_user="${SUDO_USER:-$USER}" | |
| local user_uv="$(eval echo ~"$real_user")/.local/bin/uv" | |
| # Resolve a working uv binary (might not be in root's PATH) | |
| local uv_bin="" | |
| if command -v uv &>/dev/null; then | |
| uv_bin="uv" | |
| elif [[ -x "$user_uv" ]]; then | |
| uv_bin="$user_uv" | |
| fi | |
| if [[ -z "$uv_bin" ]]; then | |
| warn "uv not found — run 'curl -LsSf https://astral.sh/uv/install.sh | sh' then 'uv sync'" | |
| return 0 | |
| fi | |
| info "Installing Python dependencies via uv..." | |
| if [[ $EUID -eq 0 && -n "${SUDO_USER:-}" ]]; then | |
| # Run uv sync as the real user so deps go into the project venv, not root's | |
| sudo -u "$SUDO_USER" "$uv_bin" sync --all-groups | |
| else | |
| "$uv_bin" sync --all-groups | |
| fi | |
| ok "Python dependencies installed" | |
| } | |
| # ── Verification ─────────────────────────────────────────────────────────── | |
| verify() { | |
| echo "" | |
| echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" | |
| info "Verifying installation..." | |
| echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" | |
| local status=0 | |
| local real_user="${SUDO_USER:-$USER}" | |
| local user_uv="$(eval echo ~"$real_user")/.local/bin/uv" | |
| # Required tools | |
| for cmd in git curl python3; do | |
| if command -v "$cmd" &>/dev/null; then | |
| ver=$("$cmd" --version 2>&1 | head -1) | |
| ok "$cmd — $ver" | |
| else | |
| fail "$cmd — NOT FOUND" | |
| status=1 | |
| fi | |
| done | |
| # uv — check both system PATH and user's ~/.local/bin | |
| if command -v uv &>/dev/null; then | |
| ok "uv — $(uv --version 2>&1 | head -1)" | |
| elif [[ -x "$user_uv" ]]; then | |
| ok "uv — $("$user_uv" --version 2>&1 | head -1) (at $user_uv)" | |
| else | |
| fail "uv — NOT FOUND" | |
| status=1 | |
| fi | |
| # Python version check | |
| python_ver=$(python3 -c "import sys; print(f'{sys.version_info.major}.{sys.version_info.minor}')" 2>/dev/null || echo "unknown") | |
| if [[ "$python_ver" < "3.11" ]]; then | |
| fail "Python $python_ver found — requires 3.11+" | |
| status=1 | |
| else | |
| ok "Python version — $python_ver" | |
| fi | |
| # pywebview native backend check | |
| if [[ "$OS" != "macos" ]]; then | |
| if python3 -c "import gi" &>/dev/null 2>&1; then | |
| ok "PyGObject (gi) — available" | |
| else | |
| warn "PyGObject (gi) — not importable (native mode will fall back to browser)" | |
| fi | |
| else | |
| ok "macOS — native WebKit available" | |
| fi | |
| echo "━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━" | |
| if [[ $status -eq 0 ]]; then | |
| echo "" | |
| ok "All system dependencies installed!" | |
| echo "" | |
| info "Next steps:" | |
| echo " 1. uv sync # Install Python deps" | |
| echo " 2. uv run poe check-all # Verify everything works" | |
| echo " 3. uv run dex-studio # Launch DEX Studio" | |
| echo " 4. uv run dex-studio --no-native # Launch in browser mode" | |
| echo "" | |
| else | |
| echo "" | |
| fail "Some dependencies are missing — see above" | |
| exit 1 | |
| fi | |
| } | |
| # ── Main ─────────────────────────────────────────────────────────────────── | |
| main() { | |
| echo "" | |
| echo "╔══════════════════════════════════════════════════════════════════╗" | |
| echo "║ DEX Studio — System Dependencies Installer ║" | |
| echo "╚══════════════════════════════════════════════════════════════════╝" | |
| echo "" | |
| detect_os | |
| info "Detected OS: $OS" | |
| echo "" | |
| ensure_sudo | |
| case "$OS" in | |
| debian) install_debian ;; | |
| fedora) install_fedora ;; | |
| arch) install_arch ;; | |
| macos) install_macos ;; | |
| esac | |
| install_uv | |
| install_python_deps | |
| verify | |
| } | |
| main "$@" | |