🚨 Setup Troubleshooter

Fixes for common issues with Intel AI Playground, 7zr.exe, and missing models.

Error 1 Installation fails with "7zr.exe not found"

The Symptom: You try to install AI Playground or download a model, and it fails immediately with an error about 7zip or archiving.

✅ The Fix: Manual 7-Zip Setup

1. Download the 7-Zip Extra package (not the installer) from 7-zip.org.
2. Extract the file. Inside you will find a file named 7za.exe or 7zr.exe.
3. Rename it to exactly 7zr.exe if it isn't already.
4. Copy this file into the AI Playground installation folder. Usually:
C:\Users\[YourName]\AppData\Local\Intel\AI-Playground\resources\app\bin\
(Note: You might need to hunt for the `bin` folder inside the installation path).
5. Alternative: Add the folder containing `7zr.exe` to your System PATH environment variable.
👉 Restart AI Playground completely after doing this.

Error 2 "Models are Missing" (but I installed them)

The Symptom: The download bar reached 100%, but the model list is empty or says "Download" again.

✅ The Fix: Check Paths & Files

1. Open AI Playground -> Settings (Gear Icon).
2. Look for "Model Path". It usually defaults to:
C:\Users\[YourName]\AI-Playground\models
3. Open that folder in File Explorer.
4. Check the subfolders checkpoints or llm.
5. Check File Size: If you see a file specific to your model (e.g., `phi3.gguf`) clearly labeled but it is 0KB or very small, the download failed. Delete it and retry.
6. Manual Move: If you downloaded the model manually (e.g. from HuggingFace), drag and drop the `.gguf` file directly into this `models` folder. Then click "Refresh" in the app.
👉 Pro Tip: Sometimes the app creates a nested folder like `models/models`. Check one level deeper!

Error 3 GIMP OpenVINO Plugin not appearing

The Symptom: You installed the plugin, but GIMP looks the same.

✅ The Fix: Python & Path Verification

1. Ensure you installed Python 3.10 (not 3.12 or 3.8).
2. Open GIMP -> Edit -> Preferences -> Folders -> Plug-ins.
3. Ensure the OpenVINO installation path is listed there.
4. If it fails, run the install_dependencies.bat inside the OpenVINO plugin folder as Administrator again.

Error 4 App Closes Immediately

The Symptom: You open AI Playground or Ollama and it just disappears.

✅ The Fix: Visual C++ Redistributable

1. You are likely missing the C++ runtimes.
2. Download and install: VC_redist.x64.exe.
3. Restart your PC.