feat: add support for Cerebras API provider and enhance MCQ functionality

Author: Xeven777

README.md

@@ -1,6 +1,6 @@
 <div align="center">
   <h1>🤖 Cluelessly Coder</h1>
-  <p>A powerful desktop application that helps developers solve coding problems by analyzing screenshots of code and providing AI-powered solutions.</p>
+  <p>A powerful desktop application that helps developers solve MCQS, coding problems by analyzing screenshots of code and providing AI-powered solutions.</p>
 
 <img src="https://i.postimg.cc/cdqKxKyy/700-1x-shots-so.jpg" alt="">
 
@@ -32,17 +32,18 @@
 
 - **Multiple AI Providers**:
   - Google Gemini (2.5 Flash, 2.0 Flash, 2.5 Pro, and more)
-  - Groq (Llama 4 and Llama 3 models)
+  - Llama (Llama 4 and Llama 3 models)
   - Deepseek (R1 Distill Llama 70B)
   - Mistral (Saba 24B)
   - Qwen (Qwen3 32B and Qwen QWQ 32B)
   - OpenAI (GPT-4o, GPT-4o Mini)
 - **Smart Model Selection**:
   - Adaptive model selection based on task complexity
   - Balance between speed and accuracy
-- **Dual Interaction Modes**:
+- **Triple Interaction Modes**:
   - **Coder Mode**: Analyze code from screenshots and get structured solutions
   - **Question Mode**: Ask conversational questions with optional screenshot context
+  - **MCQ Mode**: Analyze multiple choice questions from screenshots and get correct answers with detailed explanations
 
 ### 🛠️ Developer Experience
 
@@ -101,20 +102,20 @@
 ### Development Mode
 
 ```bash
-npm dev  # or bun run dev / yarn dev
+bun dev  # or npm run dev / yarn dev
 ```
 
 ### Production Build
 
 ```bash
 # For Windows
-npm build:win
+bun build:win
 
 # For macOS
-npm build:mac
+bun build:mac
 
 # For Linux
-npm build:linux
+bun build:linux
 ```
 
 ## 🎯 Usage Guide
@@ -135,11 +136,20 @@ npm build:linux
 4. Submit your question with `Ctrl+Enter` / `Cmd+Enter`
 5. Get conversational AI responses with helpful explanations
 
+### MCQ Mode
+
+1. Switch to MCQ Mode using the "MCQ Mode" button or `Ctrl+M` / `Cmd+M`
+2. Take a screenshot of your multiple choice question using `Ctrl+H` / `Cmd+H`
+3. Click "Analyze MCQ" to process the question
+4. Get the correct answer highlighted with detailed explanations
+5. View explanations for why other options are incorrect (when available)
+
 ### Mode Switching
 
-- **Toggle between modes**: `Ctrl+M` / `Cmd+M`
+- **Cycle through modes**: `Ctrl+M` / `Cmd+M`
 - **Coder Mode**: Best for analyzing code problems and getting structured solutions
 - **Question Mode**: Perfect for asking general programming questions, getting explanations, or seeking advice
+- **MCQ Mode**: Ideal for analyzing multiple choice questions and understanding correct answers with explanations
 
 ## ⌨️ Keyboard Shortcuts
 
@@ -148,7 +158,7 @@ npm build:linux
 | Toggle Visibility      | `Ctrl+B` / `Cmd+B`         | Show/hide the application window             |
 | Take Screenshot        | `Ctrl+H` / `Cmd+H`         | Capture a screenshot for analysis            |
 | Process/Submit         | `Ctrl+Enter` / `Cmd+Enter` | Process screenshots or submit questions      |
-| Toggle Mode            | `Ctrl+M` / `Cmd+M`         | Switch between Screenshot and Question modes |
+| Toggle Mode            | `Ctrl+M` / `Cmd+M`         | Cycle between Coder, Question, and MCQ modes |
 | Delete Last Screenshot | `Ctrl+L` / `Cmd+L`         | Remove the most recent screenshot            |
 | Reset View             | `Ctrl+R` / `Cmd+R`         | Reset to initial state                       |
 | Quit Application       | `Ctrl+Q` / `Cmd+Q`         | Exit the application                         |
@@ -202,15 +212,26 @@ The new Question Mode transforms Cluelessly Coder into a conversational AI assis
 
 Choose different models based on your needs:
 
-- **Gemini 2.5 Pro**: Advanced reasoning for most complex problems
-- **Gemini 2.5 Flash**: Best for complex problems
-- **Gemini 2.0 Flash**: Balanced performance
-- **GPT-4o**: OpenAI's most capable model
-- **Llama 4**: Scout and Maverick
-- **Llama 3**: Another Open-source alternative
-- **Deepseek**: R1 Distill Llama 70B
-- **Mistral**: Saba 24B
-- **Qwen**: Qwen3 32B , Qwen QWQ 32B
+- Gemini 2.5 Pro
+- Gemini 2.5 Flash
+- Gemini 2.0 Flash
+- GPT-4o
+- Llama 4 Scout
+- Llama 4 Maverick
+- Llama 3.1 8B
+- Llama 3.1 8B Instant
+- Llama 3.3 70B
+- Llama 3.3 70B Versatile
+- Qwen 3 32B
+- Qwen 3 235B Instruct
+- Qwen 3 235B Thinking
+- Qwen 3 480B Coder
+- Gemma 2 9B IT
+- Deepseek R1 Distill Llama 70B
+- Meta Llama Prompt Guard 2 22M
+- Meta Llama Prompt Guard 2 86M
+- MoonshotAI Kimi K2 Instruct
+- Qwen/Qwen3-32B
 
 ## 🤝 Contributing
 

src/main/lib/config-manager.ts

@@ -6,7 +6,7 @@ import OpenAI from 'openai'
 
 interface Config {
   apiKey: string
-  apiProvider: 'openai' | 'gemini' | 'groq'
+  apiProvider: 'openai' | 'gemini' | 'groq' | 'cerebras'
   extractionModel: string
   solutionModel: string
   debuggingModel: string
@@ -62,7 +62,10 @@ export class ConfigManager extends EventEmitter {
     }
   }
 
-  private sanitizeModelSelection(model: string, provider: 'openai' | 'gemini' | 'groq') {
+  private sanitizeModelSelection(
+    model: string,
+    provider: 'openai' | 'gemini' | 'groq' | 'cerebras'
+  ) {
     if (provider === 'openai') {
       const allowedModels = ['gpt-4o-mini', 'gpt-4o']
       if (!allowedModels.includes(model)) {
@@ -101,6 +104,24 @@ export class ConfigManager extends EventEmitter {
         return 'meta-llama/llama-4-scout-17b-16e-instruct'
       }
       return model
+    } else if (provider === 'cerebras') {
+      const allowedModels = [
+        'llama-4-scout-17b-16e-instruct',
+        'llama3.1-8b',
+        'llama-3.3-70b',
+        'qwen-3-32b',
+        'llama-4-maverick-17b-128e-instruct',
+        'qwen-3-235b-a22b-instruct-2507',
+        'qwen-3-235b-a22b-thinking-2507',
+        'qwen-3-coder-480b'
+      ]
+      if (!allowedModels.includes(model)) {
+        console.log(
+          `Invalid model: ${model} for provider: ${provider}. Defaulting to llama-4-scout-17b-16e-instruct`
+        )
+        return 'llama-4-scout-17b-16e-instruct'
+      }
+      return model
     }
     return model
   }
@@ -240,20 +261,25 @@ export class ConfigManager extends EventEmitter {
     return !!config.apiKey && config.apiKey.trim().length > 0
   }
 
-  public isValidApiKeyFormat(apiKey: string, provider?: 'openai' | 'gemini' | 'groq'): boolean {
+  public isValidApiKeyFormat(
+    apiKey: string,
+    provider?: 'openai' | 'gemini' | 'groq' | 'cerebras'
+  ): boolean {
     if (provider === 'openai') {
       return apiKey.trim().startsWith('sk-')
     } else if (provider === 'gemini') {
       return apiKey.trim().startsWith('AIzaSyB')
     } else if (provider === 'groq') {
       return apiKey.trim().startsWith('gsk_')
+    } else if (provider === 'cerebras') {
+      return apiKey.trim().startsWith('csk-')
     }
     return false
   }
 
   public async testApiKey(
     apiKey: string,
-    provider?: 'openai' | 'gemini' | 'groq'
+    provider?: 'openai' | 'gemini' | 'groq' | 'cerebras'
   ): Promise<{
     valid: boolean
     error?: string
@@ -263,6 +289,8 @@ export class ConfigManager extends EventEmitter {
         provider = 'openai'
       } else if (apiKey.trim().startsWith('gsk_')) {
         provider = 'groq'
+      } else if (apiKey.trim().startsWith('csk-')) {
+        provider = 'cerebras'
       } else {
         provider = 'gemini'
       }
@@ -274,6 +302,8 @@ export class ConfigManager extends EventEmitter {
       return this.testGeminiKey()
     } else if (provider === 'groq') {
       return this.testGroqKey(apiKey)
+    } else if (provider === 'cerebras') {
+      return this.testCerebrasKey(apiKey)
     }
 
     return { valid: false, error: 'Invalid provider' }
@@ -339,6 +369,37 @@ export class ConfigManager extends EventEmitter {
     }
   }
 
+  private async testCerebrasKey(apiKey: string): Promise<{
+    valid: boolean
+    error?: string
+  }> {
+    try {
+      const response = await fetch('https://api.cerebras.ai/v1/models', {
+        headers: {
+          Authorization: `Bearer ${apiKey}`,
+          'Content-Type': 'application/json'
+        }
+      })
+
+      if (!response.ok) {
+        throw new Error(`API request failed with status ${response.status}`)
+      }
+
+      const data = await response.json()
+      if (data && Array.isArray(data.data)) {
+        return { valid: true }
+      }
+
+      return { valid: false, error: 'Invalid API response' }
+    } catch (error) {
+      console.error('Cerebras API key test failed:', error)
+      return {
+        valid: false,
+        error: error instanceof Error ? error.message : 'Failed to validate Cerebras API key'
+      }
+    }
+  }
+
   public getOpacity(): number {
     const config = this.loadConfig()
     return config.opacity !== undefined ? config.opacity : 1.0

src/main/lib/processing-manager.ts

@@ -8,6 +8,7 @@ import { generateText, generateObject, CoreMessage, LanguageModel } from 'ai'
 import { createOpenAI } from '@ai-sdk/openai'
 import { createGoogleGenerativeAI } from '@ai-sdk/google'
 import { createGroq } from '@ai-sdk/groq'
+import { createCerebras } from '@ai-sdk/cerebras'
 import { z } from 'zod'
 
 export interface IProcessingManager {
@@ -68,6 +69,7 @@ export class ProcessingManager {
   private vercelOpenAI: ReturnType<typeof createOpenAI> | null = null
   private vercelGoogle: ReturnType<typeof createGoogleGenerativeAI> | null = null
   private vercelGroq: ReturnType<typeof createGroq> | null = null
+  private vercelCerebras: ReturnType<typeof createCerebras> | null = null
 
   private currentProcessingAbortController: AbortController | null = null
   private currentExtraProcessingAbortController: AbortController | null = null
@@ -89,6 +91,7 @@ export class ProcessingManager {
       this.vercelOpenAI = null
       this.vercelGoogle = null
       this.vercelGroq = null
+      this.vercelCerebras = null
 
       if (config.apiProvider === 'openai') {
         if (config.apiKey) {
@@ -112,18 +115,27 @@ export class ProcessingManager {
         if (config.apiKey) {
           this.vercelGroq = createGroq({
             apiKey: config.apiKey
-            // Add other Groq specific configurations here
           })
           console.log('Vercel Groq provider initialized successfully')
         } else {
           console.log('Vercel Groq provider not initialized: No API key provided')
         }
+      } else if (config.apiProvider === 'cerebras') {
+        if (config.apiKey) {
+          this.vercelCerebras = createCerebras({
+            apiKey: config.apiKey
+          })
+          console.log('Vercel Cerebras provider initialized successfully')
+        } else {
+          console.log('Vercel Cerebras provider not initialized: No API key provided')
+        }
       }
     } catch (error) {
       console.error('Error initializing Vercel AI provider:', error)
       this.vercelOpenAI = null
       this.vercelGoogle = null
       this.vercelGroq = null
+      this.vercelCerebras = null
     }
   }
 
@@ -136,6 +148,8 @@ export class ProcessingManager {
       return this.vercelGoogle(config.extractionModel || 'gemini-2.0-flash')
     } else if (config.apiProvider === 'groq' && this.vercelGroq) {
       return this.vercelGroq(config.extractionModel || 'meta-llama/llama-4-scout-17b-16e-instruct')
+    } else if (config.apiProvider === 'cerebras' && this.vercelCerebras) {
+      return this.vercelCerebras(config.extractionModel || 'llama-4-scout-17b-16e-instruct')
     }
     return null
   }
@@ -148,6 +162,8 @@ export class ProcessingManager {
       return this.vercelGoogle(config.solutionModel || 'gemini-2.0-flash')
     } else if (config.apiProvider === 'groq' && this.vercelGroq) {
       return this.vercelGroq(config.solutionModel || 'meta-llama/llama-4-scout-17b-16e-instruct')
+    } else if (config.apiProvider === 'cerebras' && this.vercelCerebras) {
+      return this.vercelCerebras(config.solutionModel || 'llama-4-scout-17b-16e-instruct')
     }
     return null
   }
@@ -160,6 +176,8 @@ export class ProcessingManager {
       return this.vercelGoogle(config.debuggingModel || 'gemini-2.0-flash')
     } else if (config.apiProvider === 'groq' && this.vercelGroq) {
       return this.vercelGroq(config.debuggingModel || 'meta-llama/llama-4-scout-17b-16e-instruct')
+    } else if (config.apiProvider === 'cerebras' && this.vercelCerebras) {
+      return this.vercelCerebras(config.debuggingModel || 'llama-4-scout-17b-16e-instruct')
     }
     return null
   }

src/preload/index.d.ts

@@ -1,15 +1,15 @@
 export interface ElectronAPI {
   getConfig: () => Promise<{
     apiKey?: string
-    apiProvider?: 'openai' | 'gemini' | 'groq'
+    apiProvider?: 'openai' | 'gemini' | 'groq' | 'cerebras'
     extractionModel?: string
     solutionModel?: string
     debuggingModel?: string
     language?: string
   }>
   updateConfig: (config: {
     apiKey?: string
-    apiProvider?: 'openai' | 'gemini' | 'groq'
+    apiProvider?: 'openai' | 'gemini' | 'groq' | 'cerebras'
     extractionModel?: string
     solutionModel?: string
     debuggingModel?: string

src/preload/index.ts

@@ -24,7 +24,7 @@ const electronAPI = {
   getConfig: () => ipcRenderer.invoke('get-config'),
   updateConfig: (config: {
     apiKey?: string
-    apiProvider?: 'openai' | 'gemini'
+    apiProvider?: 'openai' | 'gemini' | 'groq' | 'cerebras'
     extractionModel?: string
     solutionModel?: string
     debuggingModel?: string