This is a submission for the Hacktoberfest Open-Source AI Challenge Week 1: Touch Grass
What I Built
Every Linux enthusiast knows the pain: you download an application, and instead of using it and moving on with your day, you spend the next two hours stuck in a terminal rabbit hole. You're hunting down tar flags, chmod-ing executables, manually writing .desktop files, fixing corrupted gzip headers, tracking stray symlinks in ~/.local/bin, or dealing with permission errors.
That’s screen time nobody wants. The computer should serve you, not trap you inside a terminal debugging loop while the sun is shining outside.
I built App Installer (app-installer) to solve this: an intelligent, rootless, crash-resilient package manager and installer for Linux desktop users.
What it does:
- 📦 Zero-Friction Installs: Simply point it at any
.AppImage,.tar.gz,.tar.xz,.tar.bz2, or standalone ELF executable. - 🔍 Pre-Install Inspection & Icon Previews: Extracts and visualizes embedded icons, probes binaries, and automatically recommends desktop categories and CLI command aliases.
- 🛡️ Rootless by Default (FreeDesktop/XDG): Installs cleanly into
~/.local/opt/, links binaries to~/.local/bin/, and registers application menu launchers in~/.local/share/applications/without requiringsudo. - ⚡ Elevation on Demand: When you truly need system-level installation (
/optor/usr/local/bin), it coordinates PolicyKit (pkexec) elevation with strict safety invariants that permanently forbid accidental modifications to critical OS roots. - 🧹 Audited Lifecycles & 1-Click Purge: Maintains a complete registry of installed files so you can completely uninstall software, including cleaning up residual caches and configs.
- 🎨 Native Linux HIG Aesthetic: Built with true compact desktop controls (0px border radius, high-density toolbars) and 5 design themes (GNOME Adwaita, KDE Breeze, macOS Aqua, System76 COSMIC, and Nord) with full Dark and Light modes.
Who is it for?
Linux users, developers, and creators who want portable tools installed and working in seconds so they can shut the laptop and go touch grass.
Demo
- 📦 GitHub Releases (
v0.1.0): Download ready-to-run packages directly from GitHub Releases v0.1.0.-
Debian / Ubuntu / Pop!_OS:
app-installer_0.1.0_amd64.deb -
Universal Linux Portable:
app-installer_0.1.0_amd64.AppImage -
Standalone Executable:
app-installer-linux-x86_64
-
Debian / Ubuntu / Pop!_OS:
- 📖 Quick Launch:
wget https://github.com/SharmaDevanshu089/app-installer/releases/download/v0.1.0/app-installer_0.1.0_amd64.AppImage
chmod +x app-installer_0.1.0_amd64.AppImage
./app-installer_0.1.0_amd64.AppImage
Code
SharmaDevanshu089
/
app-installer
Native, rootless graphical application installer and package manager for Linux desktops
App Installer (app-installer)
A native, rootless graphical package manager and application installer for Linux desktops, built with Tauri v2 (Rust) and React 19 (TypeScript, Vite).
app-installer provides an enterprise-grade, standard-compliant (FreeDesktop / XDG) solution to inspect, install, configure, audit, and cleanly uninstall portable Linux applications (.AppImage, .tar.gz, .tar.xz, .tar.bz2, and standalone ELF binaries).
🌟 Key Features & Interface Philosophy
1. Dual Mode: True Dark Mode & Light Mode
- Instant Toggle: Switch between full Dark Mode and Light Mode with one click in the header bar or Preferences.
- High Contrast Dark Dropdowns: Native select controls with custom background and high-visibility contrast across all Linux themes.
-
5 Design Philosophies in both Dark and Light:
- GNOME Adwaita (GTK 4 / Libadwaita): Neutral dark charcoal and clean light surface palettes.
- KDE Breeze (Qt 6 / Kirigami): Breeze electric blue accents with geometric tech styling.
- macOS Aqua (Cupertino):…
The repository is 100% open-source under the MIT License, complete with automated bundling scripts, multi-distro installation guides (HOW_TO_INSTALL.md), and comprehensive logging diagnostics.
How I Built It
The stack is designed for native speed, minimal memory overhead, and rock-solid crash immunity:
- Backend: Rust with Tauri v2, providing high-performance file I/O, PolicyKit D-Bus execution, and asynchronous multi-tier archive parsing.
- Frontend: React 19 and TypeScript styled with Tailwind CSS, strictly constrained to zero-radius native Linux desktop components.
- AI Agentic Pair Programming: The entire application architecture, crash safeguards, multi-distro compilation pipeline, and resilient fallback extraction were engineered through iterative pair-programming with Google DeepMind's agentic AI coding assistant (Antigravity).
-
Asynchronous Architecture: Archive inspection and disk operations run in isolated background threads via
tauri::async_runtime::spawn_blocking, ensuring the Wayland/X11 GUI thread never drops connection or freezes. -
Fail-Safe Archive Engine: Tar archives often come with malformed non-UTF8 checksums or disguised compression (e.g., gzip tarballs renamed without
.gz). The engine inspects magic bytes (0x1F, 0x8B) and falls back to system GNU extractors to guarantee zero-panic operations.
Why Does Open Innovation Matter?
Desktop system management deals directly with a user’s filesystem, security permissions, and executable binaries. Closed, proprietary tools in this space are a privacy and security risk: they phone home with telemetry, lock configurations inside proprietary blobs, and cannot be audited for security invariants.
Open innovation made it possible to:
-
Ensure Absolute Privacy:
app-installerhas zero external network requests and zero telemetry. Everything runs locally and offline. - Respect Open Standards: We built directly on open FreeDesktop/XDG standards that the community spent decades establishing.
-
Transparent Security Invariants: Anyone can inspect the Rust backend to verify that protected system paths (
/,/etc,/boot) can never be compromised, even under escalated privileges.
My Agent Session
This project was built from scratch and taken across the finish line (including compilation, native deb/AppImage packaging, documentation, and GitHub release automation) through pair-programming with DeepMind's Antigravity agent harness. The agent inspected real system crashes (like Wayland compositor disconnections during heavy tar decompression), diagnosed the root cause down to gzip magic bytes, refactored the extraction pipeline to be purely asynchronous, and automated the GitHub CLI release workflows.
Prize Categories
- Best Overall "Touch Grass" Hack: Removing technical friction so users spend less time fighting Linux configs and more time in the real world.
- Most Innovative Use of Open Source AI / Agentic Development: End-to-end development, architecture hardening, and multi-format release packaging assisted by advanced agentic workflows.
Top comments (0)