Skip to content

thekishandev/CodeSnap-AI

Repository files navigation

🤖 CodeSnap AI

AI-Powered Code Analysis & Problem Solving Desktop Application

Transform screenshots into solutions with intelligent code analysis and multi-modal AI assistance


Latest Release Downloads Stars License

Electron React TypeScript Tailwind CSS

CodeSnap AI Interface

📖 Overview

CodeSnap AI is a revolutionary desktop application designed to empower developers with AI-driven code analysis and problem-solving capabilities. Simply capture screenshots of code, MCQs, or programming challenges, and let our advanced AI models provide instant, intelligent solutions and explanations.

🎯 Perfect For

  • Students learning programming concepts and solving assignments
  • Developers debugging complex code and optimizing performance
  • Interview Candidates practicing coding problems and MCQs
  • Professionals seeking quick code reviews and best practices
  • Educators explaining programming concepts with visual aids

🚀 Quick Start

📥 Installation

🪟 Windows
  1. Download: Windows Installer (.exe)
  2. Install: Run the downloaded .exe file and follow the setup wizard
  3. Launch: Find CodeSnap AI in your Start Menu or Desktop
🍎 macOS
  1. Download Options:
  2. Install:
    • DMG: Open the file and drag CodeSnap AI to Applications
    • ZIP: Extract and move to Applications folder
  3. First Launch: You may need to allow the app in System Preferences > Security & Privacy
🐧 Linux

Choose your preferred package format:

AppImage (Universal)

# Download
wget https://github.com/Kishan-Patel-dev/CodeSnap-AI/releases/latest/download/codesnap-ai-*.AppImage

# Make executable and run
chmod +x codesnap-ai-*.AppImage
./codesnap-ai-*.AppImage

Debian/Ubuntu (.deb)

# Download and install
wget https://github.com/Kishan-Patel-dev/CodeSnap-AI/releases/latest/download/codesnap-ai_*_amd64.deb
sudo dpkg -i codesnap-ai_*_amd64.deb

Snap Package

# Download and install
wget https://github.com/Kishan-Patel-dev/CodeSnap-AI/releases/latest/download/codesnap-ai_*_amd64.snap
sudo snap install codesnap-ai_*_amd64.snap --dangerous

✨ Key Features

🤖 Multi-Model AI Support

Access cutting-edge AI models for different use cases:

Provider Models Best For
🧠 Google Gemini 2.5 Pro, 2.5 Flash, 2.0 Flash Complex reasoning, code analysis
🚀 OpenAI GPT-4o, GPT-4o Mini Natural language, explanations
🦙 Meta Llama 4 Scout, 4 Maverick, 3.1 variants Performance, versatility
🧿 Qwen 3 32B, 3 235B variants Coding, mathematical problems
🤖 DeepSeek R1 Distill Llama 70B Advanced reasoning
🎭 Mistral Saba 24B Efficient processing

🎛️ Triple Interaction Modes

🖥️ Coder Mode

Analyze code from screenshots
Get structured solutions
Debug and optimize

❓ Question Mode

Ask conversational questions
Get detailed explanations
Learn programming concepts

📝 MCQ Mode

Solve multiple choice questions
Understand correct answers
Learn from explanations

🛠️ Advanced Analysis Features

  • Syntax Highlighting - Clean, readable code presentation
  • Error Detection - Identify bugs and potential issues
  • Performance Optimization - Suggestions for better efficiency
  • Step-by-step Debugging - Detailed problem-solving approach
  • Multi-language Support - JavaScript, Python, Java, C++, and more

🎨 Modern User Experience

  • True macOS Glassmorphism Design - Authentic frosted glass UI with enhanced blur effects
  • Responsive Design - Adapts to different screen sizes
  • Advanced Visual Effects - Backdrop blur and saturation for premium feel
  • Global Hotkeys - Work seamlessly across applications
  • Privacy-First - Local processing, no data collection
  • Cross-Platform - Consistent experience on all OS

⌨️ Keyboard Shortcuts

Action Windows/Linux macOS Description
Toggle Window Ctrl+B ⌘+B Show/hide application
Screenshot Ctrl+H ⌘+H Capture screen area
Process/Submit Ctrl+Enter ⌘+Enter Analyze or submit
Switch Mode Ctrl+M ⌘+M Cycle through modes
Delete Screenshot Ctrl+L ⌘+L Remove last capture
Reset View Ctrl+R ⌘+R Clear all content
Window Movement Ctrl+Arrow Keys ⌘+Arrow Keys Reposition window
Opacity Ctrl+[/] ⌘+[/] Adjust transparency
Zoom Ctrl++/-/0 ⌘++/-/0 Scale interface
Quit Ctrl+Q ⌘+Q Exit application

📚 Usage Guide

🖥️ Coder Mode (Default)

Perfect for analyzing code problems and getting structured solutions

  1. Capture Code: Press Ctrl+H (Windows/Linux) or ⌘+H (macOS)
  2. Select Area: Draw around the code you want to analyze
  3. Process: Hit Ctrl+Enter to start AI analysis
  4. Review Solutions: Browse through explanations and code suggestions
  5. Copy & Use: Select and copy the solutions you need

Question Mode

Ideal for conversational programming help and learning

  1. Switch Mode: Press Ctrl+M or click "Question Mode"
  2. Ask Anything: Type your programming question naturally
  3. Add Context: Optionally attach screenshots using "📷 Attach Screenshot"
  4. Get Help: Press Ctrl+Enter for detailed AI responses
  5. Learn: Engage in follow-up conversations

Example Questions:

  • "Can you explain how async/await works in JavaScript?"
  • "What's the difference between REST and GraphQL?"
  • "How do I optimize this database query?"

📝 MCQ Mode

Designed for multiple choice questions and exam preparation

  1. Switch Mode: Press Ctrl+M twice or click "MCQ Mode"
  2. Capture Question: Use Ctrl+H to screenshot the MCQ
  3. Analyze: Click "Analyze MCQ" to process the question
  4. Review Answer: See the correct choice highlighted
  5. Understand: Read detailed explanations for all options

🔧 Development Setup

Prerequisites

  • Node.js 18+ (LTS recommended)
  • Bun (preferred) or npm/yarn/pnpm
  • Git for version control

Local Development

# Clone the repository
git clone https://github.com/Kishan-Patel-dev/CodeSnap-AI.git
cd CodeSnap-AI

# Install dependencies (recommended)
bun install

# Alternative package managers
# npm install
# yarn install
# pnpm install

Available Scripts

# Development mode with hot reload
bun dev

# Type checking
bun run typecheck

# Linting
bun run lint

# Code formatting
bun run format

# Build for production
bun run build

# Platform-specific builds
bun run build:win    # Windows
bun run build:mac    # macOS
bun run build:linux  # Linux

Project Structure

CodeSnap-AI/
├── src/
│   ├── main/           # Electron main process
│   ├── preload/        # Preload scripts
│   └── renderer/       # React UI components
├── build/              # Build assets
├── resources/          # App icons and resources
├── .github/           # CI/CD workflows
└── web/               # Landing page

Design System

CodeSnap AI features a sophisticated glassmorphism design inspired by macOS aesthetics:

🎨 Visual Design Principles

  • Glassmorphism Effects: backdrop-blur-2xl with backdrop-saturate-150 for authentic frosted glass
  • Layered Transparency: Progressive opacity levels (white/15, white/20, white/30)
  • Enhanced Saturation: Color vibrancy boost for premium visual appeal
  • Consistent Interactions: Unified hover/active states across all components

🏗️ Component Architecture

  • Base Containers: bg-white/15 backdrop-blur-2xl backdrop-saturate-150
  • Interactive Elements: bg-white/20 hover:bg-white/30 active:bg-white/40
  • Text Hierarchy: text-white/90 (primary), text-white/60 (secondary), text-white/40 (tertiary)
  • Border Styling: border-white/30 with subtle glows and shadows

🤝 Contributing

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

🐛 Bug Reports

Found a bug? Open an issue with:

  • Clear description of the problem
  • Steps to reproduce
  • Expected vs actual behavior
  • Screenshots if applicable

💡 Feature Requests

Have an idea? Suggest a feature by describing:

  • The problem it solves
  • Proposed solution
  • Alternative approaches considered

🔧 Code Contributions

  1. Fork the repository
  2. Create a feature branch (git checkout -b feature/amazing-feature)
  3. Make your changes with clear, tested code
  4. Commit with conventional commit messages
  5. Push and open a Pull Request

Development Guidelines

  • Code Style: We use Prettier and ESLint for consistent formatting
  • Testing: Add tests for new features when applicable
  • Documentation: Update relevant docs and comments
  • Commits: Use conventional commits format

📊 System Requirements

Minimum Requirements

  • OS: Windows 10+, macOS 10.15+, or Linux (Ubuntu 18.04+)
  • RAM: 4 GB (8 GB recommended)
  • Storage: 200 MB free space
  • Display: 1366x768 minimum resolution

Recommended for Best Performance

  • RAM: 8 GB or more
  • Storage: SSD with 500 MB free space
  • Display: 1920x1080 or higher
  • Network: Stable internet for AI model access

🔐 Privacy & Security

Data Handling

  • 🛡️ Privacy-First: No personal data collection or storage
  • 🔒 Local Processing: Sensitive operations happen on your device
  • 🌐 Secure Communication: All API calls use encrypted HTTPS
  • 👁️ Transparent: Open source code for full transparency

AI Model Security

  • All AI providers maintain their own security and privacy standards
  • Screenshots are processed temporarily and not stored permanently
  • You control when and what data is sent to AI services

🚀 Roadmap

🎯 Current Focus (v1.x)

  • Multi-modal AI integration
  • Cross-platform desktop app
  • Question mode implementation
  • MCQ analysis features
  • True macOS glassmorphism UI design
  • Plugin system for custom AI models
  • Collaborative features

🔮 Future Plans (v2.x)

  • Web version for browser use
  • Mobile companion app
  • Team collaboration features
  • Custom AI model training
  • Advanced code refactoring tools
  • Integration with popular IDEs

💭 Ideas Under Consideration

  • Real-time code collaboration
  • Built-in code editor with AI assistance
  • Project-wide codebase analysis
  • Learning path recommendations

🏆 Acknowledgments

Technologies & Frameworks

Design & Assets

  • Lucide - Beautiful icon set
  • Heroicons - Additional icons
  • UI/UX Inspiration from modern design systems

Community

  • All our contributors and testers
  • The open-source community for amazing tools and libraries
  • Feedback providers helping us improve

📞 Support & Contact

🆘 Get Help

🌟 Show Support

  • Star this repository if you find it helpful
  • 🐦 Share with your developer friends
  • 💝 Contribute to make it even better

📬 Connect

Kishan Patel


Made with ❤️ by Kishan Patel

⭐ Star this repo if you found it helpful!

⬆️ Back to Top

© 2025 CodeSnap AI. Open source software under the MIT License.

About

A powerful desktop application that helps developers solve coding problems by analyzing screenshots of code and providing AI-powered solutions, alternative to interview coder and cluely.

Topics

Resources

Stars

Watchers

Forks

Packages

 
 
 

Contributors