This commit adds robust diagnostic tools to help users identify and fix
authentication issues with Twitch OAuth and Perplexity API.
New Features:
- test_credentials.py: Comprehensive credential validator with detailed diagnostics
- Tests Twitch OAuth token with IRC authentication
- Validates Perplexity API key and model access
- Provides specific error messages and actionable fixes
- Automatically tests fallback models (sonar-pro → sonar)
- TROUBLESHOOTING.md: Complete troubleshooting guide
- Common error messages and solutions
- Step-by-step diagnostic procedures
- Quick reference for file locations and commands
Improvements to setup_wizard.py:
- Enhanced Twitch token validation with detailed error messages
- Added Perplexity model fallback (sonar-pro → sonar)
- Better error handling with specific solutions
- Recommends working model if primary model unavailable
Documentation Updates:
- README.md: Added credential testing section with examples
- CLAUDE.md: Updated with new tools and testing procedures
- Comprehensive troubleshooting section in README
This addresses the common authentication failures users encounter during
initial setup and provides clear paths to resolution.
