Installation & Setup

Welcome to TweaksAI. Below is the recommended way to install and run the application on your Windows machine.

⚠️ Note: TweaksAI is currently Windows-only. macOS and Linux builds are not officially supported (yet). 📦 1. Clone the Repository

Start by cloning the official TweaksAI repo from GitHub: git clone https://github.com/TweaksAI/desktop-agent.git cd desktop-agent 🐍 2. Create a Virtual Environment

To keep things clean, set up a virtual environment:

python -m venv tweaks-env tweaks-env\Scripts\activate 📥 3. Install the Dependencies

Run the following to install all required packages: pip install -r requirements.txt

Dependencies include:

• tkinter

• Pillow

• pywin32 (for Windows shortcut creation)

• colorama (optional, for terminal styling)

• requests (reserved for future update checks) 🚀 4. Launch TweaksAI

  Run the main app script: python tweaks_ai_app.py

  On first launch, TweaksAI will:

  • 🔧 Automatically generate a desktop shortcut

  • 🎨 Load your background UI skin

  • 🧠 Launch with a welcome message and live terminal

  📂 5. Customize Your Build (Optional)

  You can swap out UI assets in the root folder:

  • TweaksAI background.jpg – background image

  • tweaks_icon.ico – app icon for shortcut

  • tweaks_ai_app.py – main app logic (editable)

  • config/ – config hooks for branding and future wallet integration