Add comprehensive credential validation and troubleshooting tools

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.
This commit is contained in:
Claude 2026-01-06 15:58:46 +00:00
parent f45f73e335
commit ddedd4867c
No known key found for this signature in database
5 changed files with 807 additions and 53 deletions

View file

@ -28,6 +28,8 @@
```
eugen/
├── chatbot.py # Main entry point
├── setup_wizard.py # Interactive setup wizard
├── test_credentials.py # Credential validation tool
├── config.py # Configuration management
├── gui.py # Dashboard GUI
├── ai_provider.py # Perplexity API integration
@ -102,12 +104,32 @@ python -m venv venv
# Install dependencies
pip install -r requirements.txt
# Run interactive setup wizard
python setup_wizard.py
# Test credentials (recommended before first run)
python test_credentials.py
# Run the bot
python chatbot.py
```
## Testing API Keys
## Testing Credentials
Use the credential validator for comprehensive testing:
```bash
python test_credentials.py
```
This tool:
- Tests Twitch OAuth token with IRC authentication
- Validates Perplexity API key and model access
- Provides detailed error diagnostics
- Suggests fixes for common issues
- Automatically tests fallback models (sonar-pro → sonar)
Manual testing:
- **Twitch**: Test IRC connection to irc.chat.twitch.tv:6667
- **Perplexity**: POST to https://api.perplexity.ai/chat/completions with a simple test message