• Streaming Responses: Watch answers appear in real-time (updates every 3 tokens or 150ms)
• Context Menu: Right-click results for:
  • Show full response (Enter)
  • Copy response (Ctrl+C)
  • Restart query (Ctrl+R)
• Multi-language Support: Works with any language
• Code Highlighting: Syntax-aware responses for code snippets
• History: Previous responses cached for quick reference
• Custom Models: Use any model from supported providers

PowerToys Settings → PowerToys Run → Plugins → QuickAI → Change ai to your preference

• Temperature: Adjust creativity (0.0 = factual, 2.0 = creative, default: 0.2)
• Max Tokens: Control response length (16-4096, default: 128)
• Request Timeout: Configure timeout in seconds (3-30, default: 8)
• Model Selection: Choose specific models per provider
• Dual API Keys: Configure backup keys for reliability

• Groq: Best for speed with Llama models
• Together: Wide variety of open-source models
• Fireworks: Fast inference with custom models
• OpenRouter: Access to multiple providers via one key
• Cohere: Enterprise-grade models with different API
• Google: Google Gemini models (API key passed as URL parameter)

Critical: Always copy the exact model name from your provider's documentation or dashboard. Model names vary by provider and must match exactly:

Examples of correct model names:

• Groq: llama-3.1-8b-instant, mixtral-8x7b-32768
• Together: meta-llama/Llama-3-8b-chat-hf, mistralai/Mixtral-8x7B-Instruct-v0.1
• Fireworks: accounts/fireworks/models/llama-v3p1-8b-instruct ⚠️ (must include full path)
• OpenRouter: meta-llama/llama-3.1-8b-instruct, anthropic/claude-3-haiku
• Cohere: command, command-light, command-nightly
• Google: gemini-1.5-flash, gemini-1.5-pro, gemini-pro

_{Example: Fireworks requires full model path like accounts/fireworks/models/llama-v3p1-8b-instruct}

Where to find correct model names:

• Groq: console.groq.com/docs/models
• Together: docs.together.ai/docs/inference-models
• Fireworks: docs.fireworks.ai/models - Copy from "Model ID" field
• OpenRouter: openrouter.ai/models
• Cohere: docs.cohere.com/docs/models
• Google: ai.google.dev/models - Google Gemini models

1. Visit https://console.groq.com
2. Sign up or log in
3. Navigate to API Keys section
4. Create a new API key
5. Copy and paste into QuickAI settings

1. Visit https://api.together.xyz
2. Create an account
3. Go to Settings → API Keys
4. Generate a new key
5. Copy and paste into QuickAI settings

1. Visit https://fireworks.ai
2. Sign up for an account
3. Navigate to API Keys
4. Create a new key
5. Copy and paste into QuickAI settings

1. Visit https://openrouter.ai
2. Sign up or log in
3. Go to Keys section
4. Generate an API key
5. Copy and paste into QuickAI settings

1. Visit https://cohere.com
2. Create an account
3. Navigate to API Keys
4. Create a new key
5. Copy and paste into QuickAI settings

1. Visit https://ai.google.dev
2. Sign up or log in with your Google account
3. Navigate to Get API Key section
4. Create a new API key
5. Copy and paste into QuickAI settings

💡 Tip: Most providers offer free tiers perfect for testing QuickAI!

• Target Framework: .NET 9.0 Windows (10.0.22621.0)
• Plugin Type: PowerToys Run Plugin (DynamicLoading: false)
• HTTP Client: Static singleton with configurable timeout (default: 8 seconds, range: 3-30)
• Streaming: Server-Sent Events (SSE) parsing with real-time UI updates
• JSON: System.Text.Json for serialization
• UI: WPF with theme-aware design

• Implements IPlugin for PowerToys Run integration
• Implements ISettingProvider for GUI configuration via AdditionalOptions
• Implements IContextMenu for right-click actions (show full response, copy, restart)
• Implements IDisposable for proper resource cleanup
• Async HTTP requests with Task.Run() for non-blocking queries
• Real-time result updates during streaming (batched every 3 tokens or 150ms for performance)
• Automatic retry with secondary API key on failure
• Thread-safe response building with StringBuilder
• Supports multiple API schemas (OpenAI, Cohere, Google Gemini)

• Validates API key presence before requests
• Handles network failures gracefully
• Shows user-friendly error messages
• Configurable timeout protection (default: 8 seconds, range: 3-30)
• JSON parsing error recovery
• Automatic fallback to secondary API key

PowerToysRun-QuickAi/
├── QuickAi/
│   ├── Community.PowerToys.Run.Plugin.QuickAi/
│   │   ├── Main.cs                    # Core plugin implementation (1275 lines)
│   │   ├── plugin.json                # Plugin manifest
│   │   ├── *.csproj                   # Project file
│   │   └── Images/
│   │       ├── ai.dark.png           # Dark theme icon
│   │       └── ai.light.png          # Light theme icon
│   └── QuickAi.sln                   # Solution file
├── assets/                            # README images and demos
├── .github/workflows/                 # CI/CD automation
└── README.md                          # This file

• ✅ Check path: %LOCALAPPDATA%\Microsoft\PowerToys\PowerToys Run\Plugins\QuickAi
• ✅ Verify files: Ensure plugin.json exists in the folder
• ✅ Restart: Completely exit and restart PowerToys
• ✅ Permissions: Run PowerToys as administrator once

• ✅ API Key: Verify your API key is correct and active
• ✅ Internet: Check connection for API requests
• ✅ Provider: Ensure selected provider is available
• ✅ Model: Verify model name is supported by provider

• ✅ Network: Check if streaming is blocked by firewall
• ✅ Timeout: Increase timeout in plugin settings
• ✅ Provider: Some providers may have streaming limitations