Lite SuiteLite Suite
← Back to Docs

Troubleshooting

Common issues and how to fix them

Troubleshooting

Common issues you may encounter when installing or using Lite Suite.

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.

Fix:

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

GPU Not Detected

Symptom: AI features 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. Restart Lite Suite after driver updates

Port Already in Use

Symptom: Lite Suite 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 via environment variables (see Configuration)

Default ports: 3773 (backend), 7423 (Agent Bridge), 7438 (Voice API), 5123 (TTS), 8080 (Whisper).

Voice Pipeline Issues

Hotkey doesn't trigger recording. Another application may have claimed the same key combination. Assign a different hotkey in Settings > Voice.

Transcription is slow or inaccurate. Try a smaller Whisper model (tiny or base) for speed, or a larger model (medium) for accuracy.

TTS not working. The TTS server starts on demand (port 5123). Ensure no other process is using that port. Check Settings > Voice for configuration.

Memory Graph Shows No Data

Fix: Confirm the LCM database has been initialized. The database file should exist at ~/.litememory/lcm.db. If it doesn't, the memory system hasn't recorded any sessions yet.

Panel Won't Open

Symptom: Clicking a panel type in the Add Panel menu does nothing.

Fix:

  1. Check the browser console for errors (Ctrl+Shift+I)
  2. Restart Lite Suite
  3. If the issue persists, try resetting workspace state in Settings

Python-Dependent Features Fail

Symptom: Features that depend on Python (MCP servers, benchmarks, agent CLI) show errors.

Fix:

  1. Ensure Python 3.10+ is installed and on your PATH
  2. Verify: python --version
  3. See Python Setup for detailed configuration

Still Stuck?

If none of the above solutions work:

  1. Check the Lite Suite logs in ~/.litesuite/logs/
  2. Join the Discord and post in #support