Troubleshooting

Common issues you may encounter when installing or using Lite Suite, and how to resolve them.

SmartScreen Warning on Installer

Symptom: Windows shows "Windows protected your PC" when running the installer.

Cause: The installer is not yet code-signed with an EV certificate. This is normal for new software.

Fix:

1. Click "More info" on the SmartScreen dialog
2. Click "Run anyway"
3. The installer will proceed normally

We are working on obtaining a code-signing certificate to eliminate this warning in future releases.

Python Not Found

Symptom: Python-based apps fail to launch with "Python not found" or "python3 is not recognized."

Fix:

1. Run lite doctor to check your Python installation
2. If Python is installed but not detected, set the path manually:

   lite config set python_path "C:\path\to\python.exe"
   

3. If Python is not installed, Lite Suite can manage it for you:

   lite install python
   

4. Restart LiteCore after making changes

GPU Not Detected

Symptom: AI/ML apps run slowly or show "No GPU detected, falling back to CPU."

Fix:

1. Ensure you have an NVIDIA GPU with updated drivers (version 535+ recommended)
2. Verify CUDA is available:

   nvidia-smi
   

3. If CUDA is not installed, download it from NVIDIA's website
4. Some apps may need a restart after driver updates
5. Run lite doctor to verify GPU detection

App Fails to Launch

Symptom: Clicking "Launch" on an app does nothing or shows an error.

Fix:

1. Check the app logs in %APPDATA%\LiteAISuite\logs\<app-name>.log
2. Run lite doctor to check for missing dependencies
3. Try reinstalling the app:

   lite uninstall <app-id>
   lite install <app-id>
   

4. If the issue persists, reach out on Discord

Port Already in Use

Symptom: A web-based app or MCP server fails to start with "EADDRINUSE" or "port already in use."

Fix:

1. Check what is using the port:

   netstat -ano | findstr :<port>
   

2. Stop the conflicting process, or change the port in the app's settings
3. Each app's port can be configured in LiteCore Settings

Virtual Environment Corrupted

Symptom: Python apps crash immediately or show import errors.

Fix:

1. Run the doctor command to detect and repair venv issues:

   lite doctor
   

2. If auto-repair fails, manually recreate the venv:

   lite uninstall <app-id> --purge
   lite install <app-id>
   

Installer Download Stalls

Symptom: The installer progress bar stops during app downloads.

Fix:

1. Check your internet connection
2. Try running the installer again -- it resumes partial downloads
3. If behind a corporate proxy, configure it:

   lite config set proxy "http://proxy:port"
   

4. Try downloading individual apps after initial install:

   lite install <app-id>
   

Still Stuck?

If none of the above solutions work:

1. Run lite doctor --verbose and save the output
2. Join the Discord and post in #support with your lite doctor output and system information