Resolve IssuesQuickly
Find solutions to common Athena AI issues with our comprehensive troubleshooting guide. Get back to building your AI relationship quickly and efficiently.
QuickSolutions
Try these common fixes first - they resolve 80% of issues in under 2 minutes.
Restart Application
Close and reopen Athena to resolve temporary glitches and refresh connections.
Check Internet
Verify your internet connection is stable for cloud features and synchronization.
Audio Permissions
Ensure Athena has microphone and speaker permissions in your system settings.
Still Having Issues?
If these quick fixes don't help, browse the detailed troubleshooting sections below or contact our support team for personalized assistance.
DetailedTroubleshooting
Select a category to find specific solutions for your issue.
Installation Issues
Problems with downloading, installing, or setting up Athena
Connection Problems
Network connectivity and server communication issues
Voice & Audio
Microphone, speakers, and voice recognition problems
Performance Issues
Slow responses, lag, or resource consumption problems
Sync & Data
Cross-device synchronization and data consistency issues
Installation Issues
Installation Fails on Windows
The Windows installer fails to complete or shows "Access Denied" errors.
Solutions:
- Right-click the installer and select "Run as administrator"
- Temporarily disable Windows Defender or antivirus software
- Check available disk space (minimum 2GB required)
- Close all other applications during installation
winget install Aethyr.AthenamacOS Security Warning
macOS shows "app from unidentified developer" or Gatekeeper warnings.
Solutions:
- Go to System Preferences → Security & Privacy
- Click "Allow" next to the blocked Athena application
- Or Control-click the app and select "Open" from the menu
- For persistent issues, run:
sudo spctl --master-disable
Linux Dependencies Missing
Linux installation fails due to missing system dependencies.
sudo apt update && sudo apt install -y libasound2-dev libgtk-3-dev libwebkit2gtk-4.0-devAdvancedTroubleshooting
Technical solutions for complex issues and system administrators.
Reset Local Database
Clear all local data and resync from cloud (nuclear option).
athena --reset-databaseDebug Mode
Enable verbose logging for detailed troubleshooting.
athena --debug --log-level=verboseNetwork Diagnostics
Test network connectivity and latency to Aethyr servers.
athena --network-testSystem Health Check
Comprehensive system and app health diagnostics.
athena --health-check⚠️ Advanced Commands Warning
These commands can modify or delete your data. Always backup your conversations before running advanced troubleshooting commands.
Learn About Data BackupStill Need Help?
Our support team is here to help you resolve any issues and get back to building your relationship with Athena.
Live Chat
Get instant help from our support team
Documentation
Comprehensive guides and tutorials
Community
Connect with other Athena users