🚀 Getting Started
Installation
Install EZGPT.APP from the Chrome Web Store for the best experience:
- Visit the Chrome Web Store page (link coming soon)
- Click "Add to Chrome"
- The extension icon will appear in your toolbar
- Click the icon to open EZGPT.APP
First Steps
- Add a Provider: Go to Settings tab and add your first AI provider
- Test Connection: Use the "Test Connection" button to verify your setup
- Start Chatting: Switch to Chat tab and select your provider
- Explore Features: Try keyboard shortcuts and detached window mode
🤖 Provider Setup
Local LLM Providers
LMStudio
Configuration:
- Name: Local LMStudio
- API URL:
http://localhost:1234/v1
- API Key: (leave empty)
- Model: Your loaded model name
- Context Window: 8K tokens (adjust based on your model)
Note: Make sure LMStudio's local server is running before connecting.
Ollama
Configuration:
- Name: Local Ollama
- API URL:
http://localhost:11434/v1
- API Key: (leave empty)
- Model: llama2 (or your installed model)
- Context Window: 4K tokens (model dependent)
Note: Run ollama serve to start the server first.
Cloud Providers
OpenAI
Configuration:
- Name: OpenAI GPT-4
- API URL:
https://api.openai.com/v1
- API Key: sk-your-api-key-here
- Model: gpt-4 or gpt-3.5-turbo
- Context Window: 128K tokens (for GPT-4)
Context Window Settings
The context window determines how much conversation history is sent to the AI:
- 4K tokens: ~3,000 words (older models)
- 8K tokens: ~6,000 words (common for local models)
- 32K tokens: ~24,000 words (newer models)
- 128K tokens: ~96,000 words (latest models like GPT-4)
💬 Chat Features
Basic Chat
- Send Messages: Type and press Enter, or click Send button
- New Chat: Click the 💬 button to start fresh
- Provider Switch: Change providers mid-conversation
- Refresh Providers: Use ↻ button to reload provider list
Chat History
- Search Chats: Use the search box to find conversations
- Rename Chats: Click chat titles to rename them
- Delete Chats: Remove individual or all conversations
- Provider Filtering: History is organized by provider
Context Management
EZGPT automatically manages conversation context:
- Token Estimation: Calculates message sizes automatically
- Auto Truncation: Removes old messages when needed
- Context Warnings: Shows when messages are truncated
- Smart Preservation: Keeps recent and important messages
🔥 Advanced Features
Detached Window Mode
Open EZGPT in a separate window for better multitasking:
- Click the ⧉ button in the top-right corner
- Window is resizable and remembers position
- Independent settings from popup mode
- Perfect for side-by-side workflows
Theme Customization
Personalize your EZGPT experience:
- Themes: Light, Dark, or Auto (follows system)
- Color Schemes: Purple, Blue, Green, Orange, Pink
- Font Sizes: Small, Medium, Large, Extra Large
- Density: Compact, Comfortable, Spacious
Collapsible Settings
Keep your interface clean and organized:
- Click section headers to expand/collapse
- Settings remember their collapsed state
- Available in both popup and window modes
- Separate state for each interface
⌨️ Keyboard Shortcuts
Ctrl + Enter
Send message
Ctrl + N
New chat
Ctrl + F
Search chats
Alt + 1-9
Switch providers (1-9)
Escape
Close search/cancel
Note: Shortcuts work in both popup and detached window modes.
⚙️ Settings Guide
Appearance Settings
- Theme: Choose your preferred color theme
- Color Scheme: Select accent colors
- Font Size: Adjust text readability
- View Density: Control spacing and compactness
Provider Settings
- Add Provider: Configure new AI services
- Edit Provider: Modify existing configurations
- Test Connection: Verify provider settings
- Delete Provider: Remove unused providers
Data Management
- Chat History: Automatically saved per provider
- Settings Sync: Separate for popup and window
- Clear Data: Remove all chats or specific conversations
- Export/Import: (Coming in future updates)
🔒 Privacy & Security
Data Storage
- Local Only: All data stored in your browser
- No Cloud Sync: Nothing sent to our servers
- Provider-Specific: Each provider's chats stored separately
- User Control: You can delete all data anytime
Network Requests
- Direct API Calls: Only to your configured providers
- No Intermediary: No proxy servers or logging
- Local Models: Complete privacy with LMStudio/Ollama
- API Keys: Stored locally, never transmitted to us
Permissions
EZGPT.APP requires minimal permissions:
- Storage: Save your settings and chat history
- Active Tab: Detect when extension is used
- Host Permissions: Connect to your AI providers
No Telemetry
- No usage analytics or tracking
- No error reporting to external services
- No automatic updates that send data
- Complete transparency in our open-source code