# ARIA Installation & PWA Guide

This guide details the steps to download, install, and run **ARIA (Autonomous Research & Intelligence Assistant)** as a standalone application on desktop and mobile platforms.

---

## 1. Windows Desktop Installation

We created a lightweight Windows wrapper package. It launches ARIA instantly in a 100% borderless, standalone desktop window (no browser top bar or tabs) using Microsoft Edge or Google Chrome on the user's PC.

### Installation Steps
1. **Download the Wrapper:**
   Click [here](https://aria-2-f3kq.onrender.com/aria-desktop-app.zip) to download `aria-desktop-app.zip`.
2. **Extract Files:**
   Extract the `.zip` archive to a folder of your choice (e.g., `C:\Program Files\ARIA` or your Desktop).
3. **Launch:**
   Double-click the extracted `run_aria.bat` batch script to install required Python dependencies (on first run) and start ARIA locally.

*Website HTML/Button code snippet:*
```html
<a href="https://aria-2-f3kq.onrender.com/aria-desktop-app.zip" download="aria-desktop-app.zip" style="padding: 10px 20px; background-color: #00E5FF; color: #0A0A0F; font-weight: bold; border-radius: 8px; text-decoration: none; display: inline-flex; align-items: center; gap: 8px;">
  Download for Windows
</a>
```

---

## 2. macOS Installation (Safari / Chrome PWA)

macOS users can install ARIA as a native dock application utilizing standard Progressive Web App (PWA) configurations:

### Safari (macOS Sonoma & Newer)
1. Open Safari and navigate to: `https://aria-2-f3kq.onrender.com`
2. Go to the menu bar at the top and select **File &rarr; Add to Dock...**
3. Confirm the application name (**ARIA**) and click **Add**.
4. ARIA will now appear in your macOS Dock and Applications folder as a standalone app with its brand icon.

### Chrome / Edge (macOS)
1. Open Google Chrome or Microsoft Edge and navigate to: `https://aria-2-f3kq.onrender.com`
2. Look at the right side of the address bar at the top. Click the **Install ARIA** icon (looks like a monitor with a down arrow).
3. Confirm the installation. The app will open in a borderless window and be saved to your Chrome Apps directory.

---

## 3. Mobile Installation (Android & iOS)

Mobile platforms block unknown `.apk` or `.ipa` installations by default for security. To bypass this seamlessly, ARIA utilizes Google and Apple's WebAPK / Progressive Web App (PWA) standard. When users save the app to their home screen, it functions like a native application with custom brand typography and icon assets.

### Android (Google Chrome)
1. Open Google Chrome and navigate to: `https://aria-2-f3kq.onrender.com`
2. Tap the three-dot menu button at the top-right of Chrome.
3. Select **Add to Home screen** (or **Install app** if prompted).
4. Tap **Add** to confirm. The system will compile the WebAPK in the background, adding ARIA to your home screen and app drawer.

### iOS / iPadOS (Apple Safari)
1. Open Apple Safari and navigate to: `https://aria-2-f3kq.onrender.com`
2. Tap the **Share** button (box with an up arrow) at the bottom (iPhone) or top (iPad) toolbar.
3. Scroll down the sharing menu and select **Add to Home Screen**.
4. Tap **Add in the top-right corner**. ARIA is saved directly to your home screen with its premium brand icon.

*Website HTML/Button code snippet:*
```html
<a href="https://aria-2-f3kq.onrender.com" target="_blank" style="padding: 10px 20px; background-color: #1F2937; color: #F5F7FA; font-weight: bold; border-radius: 8px; text-decoration: none; display: inline-flex; align-items: center; gap: 8px;">
  Install on Android / iOS
</a>
```

---

## How to push this live on Streamlit Cloud

To update these links, installation guidelines, and app features on your live site, run the following commands in your repository terminal to commit your changes and push them to GitHub:

```bash
git add .
git commit -m "feat: add professional ARIA download buttons, options, and guides"
git push origin main
```

Once pushed, the new Windows Download button, mobile installer guidelines, and brand new typography app icon will immediately render live in the Settings panel of the ARIA deployment!