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:
parent
f45f73e335
commit
ddedd4867c
5 changed files with 807 additions and 53 deletions
24
CLAUDE.md
24
CLAUDE.md
|
|
@ -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
|
||||
|
||||
|
|
|
|||
Loading…
Add table
Add a link
Reference in a new issue