Troubleshooting
Troubleshooting
Common issues and solutions for Neoly.
Quick Diagnostics
Before diving in:
- Restart Neoly - Fixes most issues
- Check internet - Required for AI
- Check credits - AI needs credits
- Update Neoly - Get latest version
Common Issues
App Won't Start
| Cause | Solution |
|---|---|
| Windows version | Update to Windows 10 2004+ |
| Antivirus blocking | Add Neoly to whitelist |
| Corrupt install | Reinstall Neoly |
| Permissions | Run as Administrator |
Invisibility Not Working
| Cause | Solution |
|---|---|
| Old Windows | Update to version 2004+ |
| Window minimized | Keep window visible |
| Graphics driver | Update display drivers |
See Invisibility for details.
AI Not Responding
| Cause | Solution |
|---|---|
| No credits | Purchase credits or upgrade |
| No internet | Check connection |
| Server down | Wait and retry |
| Auth expired | Sign out and sign in |
Voice Not Working
| Cause | Solution |
|---|---|
| No mic permission | Grant in Windows Settings |
| Wrong device | Select correct input device |
| Mic muted | Unmute microphone |
See Audio Troubleshooting for details.
Error Messages
| Error | Meaning | Solution |
|---|---|---|
| INSUFFICIENT_CREDITS | Out of credits | Upgrade or buy top-up |
| AUTHENTICATION_ERROR | Session expired | Sign in again |
| NETWORK_ERROR | Connection failed | Check internet |
| MODEL_NOT_AVAILABLE | Model not in your plan | Use different model |
| RATE_LIMITED | Too many requests | Wait and retry |
Getting Help
If issues persist:
- Check Audio and Connection guides
- Email: support@neoly.ai
- Include: Version, OS, error message, steps to reproduce
See also: Audio Issues | Connection Issues