ESHU Premium - AI-Powered Linux Package Installer

# ESHU Premium - The Ultimate Linux Package Manager (NOW with eshu-trace and Ghost-Mode)

**One command for every package. AI-powered universal installer that just works.**

ESHU is an intelligent package search agent and installer that unifies ALL Linux package managers under a single natural language interface. No more remembering whether to use `pacman`, `apt`, `yay`, `cargo`, `npm`, or any other package manager - just tell ESHU what you want.

---

## What's Included in Premium?

Get **EVERYTHING** - The ultimate Linux package management solution:
- ✅ **Unlimited Eshu-Trace** ($19.99 value) - Find & fix breaking packages
- ✅ **Full Eshu Installer Premium** - AI-powered package management
- ✅ **Ghost Mode** - Try packages without installing (`eshu try gimp`)
- ✅ **Conflict Oracle** - Prevent conflicts BEFORE installation
- ✅ **Eshufile** - Sync your setup across any Linux distro
- ✅ **AI-powered bundles** - Smart package suggestions
- ✅ **Unlimited AI queries** - No daily limits (free tier: 10/day)
- ✅ **System snapshots** - Time Machine for Linux
- ✅ **Automated testing** - Boots VMs, runs tests automatically
- ✅ **Priority support** - Direct access to dev team

### 📦 Eshu's Path - Curated Package Bundles (NEW!)
The killer feature that saves you HOURS:

- **Installing Hyprland?** Get the complete Wayland ecosystem (15 packages) in one command
- **NVIDIA drivers?** Get the full proprietary stack automatically
- **Rust development?** Get the complete toolchain
- **10+ curated paths** for common setups

**No more researching what packages you need. No more missing dependencies. No more broken setups.**

### 🤖 Unlimited AI Queries
- **Free tier:** 10 AI queries/day
- **Premium:** Unlimited intelligent recommendations
- Natural language package search
- Smart error analysis and auto-fixing

### 📸 Time Machine - System Snapshots
- Automatic snapshots before every installation
- One-click rollback if something breaks
- Never worry about breaking your system again
- Supports Timeshift and Btrfs

### Eshu-Trace (Normally $19.99 Standalone)

**Find & fix breaking packages automatically:**
- Binary search finds culprit in ~6 steps (not 47!)
- Automatic downgrade/pin/remove after finding the problem
- Works from recovery mode/live USB when system won't boot
- Cross-distro support (Arch, Debian, Fedora, etc.)

### 🧹 Smart Bloat Analyzer
- Find and remove orphaned packages
- Detect duplicate installations across package managers
- Identify large unused packages
- Reclaim gigabytes of disk space

### ⚠️ Community Hardware Warnings
- Hardware-specific compatibility alerts
- Known issue detection before installation
- Automatic workaround suggestions
- Learn from the community's experience

### 💡 Lightweight Alternatives
- AI suggests lighter packages when you're low on RAM
- Optimized recommendations for your system specs
- Perfect for older hardware or minimal setups

### 🎯 Priority Support
- 24-hour response time
- Direct access to developers
- Feature requests prioritized
- Help with complex setups

---

## Why ESHU Premium?

### Before ESHU:
```bash
# You want Hyprland...
pacman -S hyprland  # OK, installed
hyprctl  # ERROR: no terminal!
# *searches Google for "wayland terminal"*
pacman -S kitty
# *launches Hyprland, can't open apps*
# *searches for "wayland launcher"*
pacman -S wofi
# *no notifications*
# *no screenshots*
# ... 2 hours later, still missing things
```

### With ESHU Premium:
```bash
eshu install hyprland

📦 Eshu's Path Available!
Complete Hyprland Setup

Includes 15 packages: hyprland, kitty, wofi, waybar,
mako, grim, slurp, wl-clipboard, swaylock, swayidle,
xdg-desktop-portal-hyprland, polkit-gnome, pipewire,
wireplumber, brightnessctl

Install complete bundle? [Y/n] y

✅ Done! Complete working setup in one command.
```

**That's the power of Eshu's Path.**

---

## Perfect For:

✅ **Arch Linux users** tired of researching AUR packages
✅ **New Linux users** who don't know all the package managers yet
✅ **Distro hoppers** who switch between Arch, Debian, Fedora
✅ **Developers** who need Python, Rust, Node packages fast
✅ **Power users** who want intelligent package recommendations
✅ **Anyone** who values their time

---

## Supported Package Managers

ESHU searches across ALL of these simultaneously:

- **pacman** (Arch Linux)
- **yay/paru** (AUR)
- **apt** (Debian/Ubuntu)
- **flatpak** (Universal)
- **snap** (Universal)
- **cargo** (Rust packages)
- **npm** (Node.js packages)
- **pip** (Python packages)
- **github repos** (Trusted GitHub package sourcing)
- More coming soon!

---

## Installation


```bash
# 1. Install Eshu Installer
curl -sSL https://raw.githubusercontent.com/eshu-apps/eshu-installer/main/install-eshu.sh | bash

# 2. Activate Premium (auto-unlocks everything)
eshu license activate YOUR_LICENSE_KEY your@email.com

# 3. Install Eshu-Trace
curl -L github.com/eshu-apps/eshu-trace/releases/latest/download/eshu-trace-linux-amd64 -o eshu-trace
chmod +x eshu-trace
sudo mv eshu-trace /usr/local/bin/

# 4. Use unlimited trace via eshu!
eshu trace bisect
eshu trace recovery
```

Your Premium license automatically grants unlimited Eshu-Trace access!
---

## Technical Details

- **Platform:** Linux (all distributions)
- **Requirements:** Python 3.9+
- **License:** Per-user license key
- **Support:** Email support, GitHub issues
- **Updates:** Free updates for life of subscription

---

## Pricing

**$9.99/month** - Cancel anytime

Your license key will be delivered immediately after purchase via email.

---

## Questions?

- 📧 Email: eshu-apps@proton.me
- 💬 GitHub: https://github.com/eshu-apps/eshu-installer
- 📖 Docs: https://github.com/eshu-apps/eshu-installer/blob/main/README.md

---

## Try ESHU Free First

Download the free version to test basic features:
👉 https://github.com/eshu-apps/eshu-installer

**Free version includes:**
- Multi-manager package search
- Basic installation
- System profiling
- 10 AI queries/day
- 3 Free traces

**Upgrade to Premium when you're ready for:**
- Eshu's Path curated bundles
- Unlimited AI queries
- System snapshots
- Smart cleanup tools

---

**One command for every package. AI-powered universal Linux installer.**

🚀 **Less Time with Basic Configuring. More Time Developing. Upgrade to ESHU Premium today.**
```