🤖 Cluelessly Coder

A powerful desktop application that helps developers solve MCQS, coding problems by analyzing screenshots of code and providing AI-powered solutions.

• Latest Release
• Windows (x64)
• Linux (AppImage)
• Linux (deb)
• Linux (snap)

• Works seamlessly on Windows, macOS, and Linux
• Native performance with Electron

• Multiple AI Providers:
  • Google Gemini (2.5 Flash, 2.0 Flash, 2.5 Pro, and more)
  • 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
• 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

• Code Analysis:
  • Syntax highlighting
  • Error detection
  • Performance optimization suggestions
• Debugging Tools:
  • Step-by-step debugging
  • Variable inspection
  • Runtime analysis

• Responsive design
• Intuitive keyboard shortcuts

• Local processing of sensitive data
• Optional cloud sync
• No data collection

• Node.js 18+ (LTS recommended)
• npm, yarn, or pnpm
• Git

1. Clone the repository

   git clone https://github.com/Xeven777/clueless-coder.git
   cd clueless-coder

2. Install dependencies

   # Using bun (recommended)
   bun i
   
   # Or using pnpm
   pnpm install
   
   # Or using yarn
   yarn install

bun dev  # or npm run dev / yarn dev

# For Windows
bun build:win

# For macOS
bun build:mac

# For Linux
bun build:linux

1. Launch the application
2. Capture code using Ctrl+H (or Cmd+H on Mac)
3. Let the AI analyze your code Ctrl+Enter
4. Browse through solutions and explanations
5. Copy the code or debug information

1. Switch to Question Mode using the "Question Mode" button or Ctrl+M / Cmd+M
2. Type your question in the text area
3. Optionally attach screenshots for context using "📷 Attach Screenshot"
4. Submit your question with Ctrl+Enter / Cmd+Enter
5. Get conversational AI responses with helpful explanations

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)

• 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

The new Question Mode transforms Cluelessly Coder into a conversational AI assistant for developers:

• Natural Language Queries: Ask questions in plain English about programming concepts, debugging, or code optimization
• Multimodal Support: Combine text questions with screenshot context for better understanding
• Conversational Responses: Get detailed explanations, not just code snippets
• Context-Aware: Attach screenshots to provide visual context for your questions

• Learning: "Can you explain how async/await works in JavaScript?"
• Debugging: "Why is my React component not re-rendering?" (with screenshot)
• Best Practices: "What's the best way to handle errors in Python?"
• Code Review: "Is there a more efficient way to write this algorithm?" (with code screenshot)
• Architecture: "Should I use Redux or Context API for this use case?"

1. Switch to Question Mode using the button or Ctrl+M / Cmd+M
2. Type your question in natural language
3. Optionally attach screenshots for visual context
4. Get detailed explanations tailored to your specific needs

• JavaScript/TypeScript
• Python
• Java
• C/C++
• C#
• Go
• Ruby
• And more...

Choose different models based on your needs:

• 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

We welcome contributions! Here's how you can help:

1. Fork the repository
2. Create a feature branch (git checkout -b feature/amazing-feature)
3. Commit your changes (git commit -m 'Add some amazing feature')
4. Push to the branch (git push origin feature/amazing-feature)
5. Open a Pull Request

# Install dependencies
bun install

# Run linter
bun lint

# Run tests
bun test

# Build the application
bun build

• Built with Electron Vite
• Icons by Lucide
• UI components powered by Radix UI
• Special thanks to all contributors and the open-source community

Have questions or suggestions? Feel free to open an issue or reach out to us!