🔧 Installation Issues
Extension doesn't appear after installation
Solution:
- Check if the extension is enabled in
chrome://extensions/
- Look for the EZGPT icon in your browser toolbar
- If hidden, click the puzzle piece icon and pin EZGPT.APP
- Try reloading the extension or restarting your browser
Chrome Web Store installation fails
Solution:
- Ensure you're using a supported browser (Chrome, Edge, etc.)
- Check that you're signed in to your Google account
- Try refreshing the Chrome Web Store page
- Clear browser cache and try installing again
- Restart your browser and retry the installation
🌐 Connection Problems
Cannot connect to local LLM (LMStudio/Ollama)
Solution:
- Verify your local server is running and accessible
- Check the URL format:
http://localhost:1234/v1 for LMStudio
- Ensure no firewall is blocking the connection
- Try
http://127.0.0.1:PORT/v1 instead of localhost
- Use the "Test Connection" button to verify settings
OpenAI API connection fails
Solution:
- Verify your API key is correct and active
- Check your OpenAI account has sufficient credits
- Ensure URL is
https://api.openai.com/v1
- Test with a simple model like
gpt-3.5-turbo first
🧠 Context Window Errors
Getting "context length exceeded" errors
Solution:
- Reduce the Context Window setting for your provider
- Start a new chat to clear conversation history
- Check your model's actual context limit
- The extension will automatically truncate when possible
Context truncation warnings appearing frequently
Solution:
- Increase the Context Window setting if your model supports it
- Use shorter messages to preserve more conversation history
- Start new chats more frequently for complex topics
- This is normal behavior for models with smaller context windows
🎨 UI Problems
Collapsible settings won't expand/collapse
Solution:
- Click directly on the header text or arrow button
- Try refreshing the extension popup
- Check if you're in the detached window - it has separate settings
- Disable and re-enable the extension if issues persist
Theme/appearance settings not working
Solution:
- Settings are saved separately for popup and detached window
- Try changing settings in both locations
- Refresh the extension or restart your browser
- Check if browser dark mode is overriding settings