Offline AI USB troubleshooting
Fix launch blockers and slowdowns without going online. Use this playbook when you’re traveling, off-grid, or in the middle of an outage.
First checks
Before deep debugging, verify basics. Most issues clear after a clean relaunch with a stable port and power.
- Close and reopen the launcher, then reinsert the USB if needed.
- Use a direct USB 3.0 port; avoid crowded hubs or low-power adapters.
- Check that your browser is pointed to the localhost URL the launcher prints.
Windows-specific fixes
If Windows blocks the app or keeps it slow, start here.
SmartScreen & AV
Approve “Run anyway” after verifying the publisher. Add the launcher folder to AV exclusions to avoid repeated scans.
Antivirus exclusions guideNo-admin environments
If IT locks down installs, use the no-admin checklist before you travel.
No-admin guidemacOS-specific fixes
macOS may ask for approval the first time you run the launcher.
- Open System Settings → Privacy & Security and click “Open Anyway” after your first attempt.
- Allow terminal network prompts for localhost if asked; no external traffic is required.
- Keep the USB on a primary USB/Thunderbolt port to avoid power dips.
Performance and stability
When responses lag or the system feels hot, tune the preset and environment.
Quick speed ups
Switch to the fast preset, close heavy apps, and stay on AC power.
Storage & ports
Use USB 3.0, avoid slow hubs, and keep at least a few GB free on the laptop.
UI or black screen issues
If the browser shows a blank page or the window is slow to open, use these checks before reinstalling anything.
- Ensure the launcher terminal is still running; don’t close it while using the UI.
- Try a different browser if extensions are blocking localhost traffic.
- Follow the black screen guide for step-by-step fixes.
Stay operational offline
Keep the essentials nearby: requirements, model presets, and update guide. If hardware fails, have a second drive or a way to order one fast.