🚀 ArchScriptGen

---

💡 About

ArchScriptGen is a GUI-based tool that helps you generate complete Arch Linux installation and configuration scripts using AI.

Built with PyQt6 + Groq API, it simplifies the complex Arch setup process into an intuitive visual workflow.

---

✨ Features

• 🖥️ Modern GUI built with PyQt6

• 🤖 AI-powered script generation (Groq - LLaMA 3.3)

• 🎨 Theme selection with live preview

• 🧩 Desktop Environment chooser (GNOME, KDE, i3, XFCE, etc.)

• 📦 Search and install apps from Arch repositories

• 🖱️ Cursor theme selection

• ⚙️ Advanced system configuration:

  • Bootloader selection
  • Kernel selection
  • User & hostname setup
  • Network & drivers

• 🌐 Wallpaper & dotfiles integration

• 💾 Export scripts as .sh files

---

🚀 Quick Start

ARCH USER REPOSITORY(AUR) RECOMMENDED

1. To install YAY -

   sudo pacman -S --needed git base-devel
   git clone https://aur.archlinux.org/yay.git
   cd yay
   makepkg -si

2. Install the app -

   yay -S arch-script-gen

3. Run the app -

   arch-script-gen

4. Enter your groq api key
5. Start generating your arch script gen

---

ARCH LINUX -

1. Download the latest arch executable from the releases section
2. In a terminal or dolphin, go to the directory in which the file has been downloaded
3. In dolphin, double click the executable/in terminal, run -

./arch-script-gen

4. Enter your free groq API key
5. Atart generating scripts right away.

---

WINDOWS-

1. Download the latest version from Releases
2. Extract the .zip file
3. Open the folder
4. Run:

ArchScriptGen.exe

5. Enter your Groq API key when prompted
6. Start generating your Arch install script

---

🔑 API Key Setup

This app uses the Groq API for AI script generation. You need your Own API key Get your free API key here: 👉 https://console.groq.com/keys

✔ Stored locally on your machine ✔ Never uploaded or shared

---

⚠️ Requirements

• Windows/Linux(No WSL)
• Internet connection (required for API + package search)

---

🧠 How It Works

1. Select your shell
2. Select your system preferences (DE, apps, drivers, etc.)
3. The app sends your request to Groq AI
4. AI generates a complete Arch Linux bash script
5. You can get personalised changes using the chatbot
6. You can review and export it

---

📸 Screenshots

🏠 Home — AI Script Generation

Configure your system, hit Generate Script, and get a complete Arch install script powered by Groq AI. Refine it further using the built-in chatbot on the left.

---

🖥️ Desktop Environment

Choose your DE (GNOME, KDE, i3, XFCE and more) with a live preview so you know exactly what you're getting before you install.

---

🎨 Global Themes

Pick from popular themes like Catppuccin with a visual grid preview — no more guessing what a theme looks like after the fact.

---

🖱️ Mouse Pointer Styles

Browse and select cursor themes with full previews built right into the app.

---

📦 Discover Apps

Search the Arch repositories and add packages directly to your install script without touching a terminal.

---

⚙️ Settings

Configure hostname, username, shell, bootloader, kernel, display manager, timezone and more — all from one page.

---

✅ View Selections

Review every option you've chosen before generating the script. Select or deselect individual components with a single click.

---

🔑 API Key Setup

Get a free Groq API key at console.groq.com and paste it here. Stored locally — never shared.

⚠️ Disclaimer

• This tool generates scripts only — it does NOT install Arch Linux directly
• Always review generated scripts before running them
• Use at your own risk

---

✨ Features Overview

Feature	Status
GUI Interface	✅
AI Script Generation	✅
App Installer	✅
Theme Preview	✅
Cursor Selection	✅
Full Auto Installer	🚧
ISO Builder	🚧

---

📁 Project Structure

project/
├── main.py
├── themes/
├── cursors/
├── DesktopEnvironment/
├── README.md
└── LICENSE

---

🛠️ Tech Stack

• Python
• PyQt6
• Groq API
• Requests
• PyInstaller

---

🐞 Known Issues

• First launch may be slow (PyInstaller extraction behavior)
• Large executable size due to PyQt6 bundling(332mb)

---

🚀 Future Plans

• Full automated Arch installer scripts
• Disk partitioning UI
• Arch ISO builder integration (archiso)
• Plugin system for custom configs
• Performance optimizations

---

🤝 Contributing

Contributions are welcome!

• Open an issue
• Submit a pull request
• Suggest new features

---

⭐ Support

If you like this project:

👉 Give it a star ⭐ on GitHub

---

📜 License

This project is licensed under the MIT License.

---