🤖 Cluelessly Coder

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

📥 Download

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

✨ Features

🖥️ Multi-Platform Support

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

🤖 AI-Powered Coding

• Multiple AI Providers:
  • Google Gemini (2.5 Flash, 2.0 Flash, 1.5 Pro, and more)
  • Groq (Llama 4 and Llama 3 models)
  • OpenAI (GPT-4o, GPT-4o Mini)
• Smart Model Selection:
  • Adaptive model selection based on task complexity
  • Balance between speed and accuracy

🛠️ Developer Experience

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

🎨 Beautiful UI/UX

• Responsive design
• Intuitive keyboard shortcuts

🔒 Privacy Focused

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

🚀 Quick Start

Prerequisites

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

Installation

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

🏃‍♂️ Running the Application

Development Mode

npm dev  # or bun run dev / yarn dev

Production Build

# For Windows
npm build:win

# For macOS
npm build:mac

# For Linux
npm build:linux

🎯 Usage Guide

Basic Workflow

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

⌨️ Keyboard Shortcuts

Action	Shortcut
Toggle Visibility	Ctrl+B / Cmd+B
Take Screenshot	Ctrl+H / Cmd+H
Process Screenshot	Ctrl+Enter / Cmd+Enter
Delete Last Screenshot	Ctrl+L / Cmd+L
Reset View	Ctrl+R / Cmd+R
Quit Application	Ctrl+Q / Cmd+Q
Move Window	Ctrl+Arrow Keys
Decrease Opacity	Ctrl+[ / Cmd+[
Increase Opacity	Ctrl+] / Cmd+]
Zoom Out	Ctrl+- / Cmd+-
Zoom In	Ctrl+= / Cmd+=
Reset Zoom	Ctrl+0 / Cmd+0

Supported File Types

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

🛠️ Configuration

Model Selection

Choose different models based on your needs:

• Gemini 2.5 Flash: Best for complex problems
• Gemini 2.0 Flash: Balanced performance
• Gemini 1.5 Pro: Advanced reasoning
• GPT-4o: OpenAI's most capable model
• Llama 4: Scout and Maverick
• Llama 3: Another Open-source alternative

🤝 Contributing

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

Development Setup

# Install dependencies
bun install

# Run linter
bun lint

# Run tests
bun test

# Build the application
bun build

🙏 Acknowledgments

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

📬 Contact

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

---

Made with ❤️ by Xeven