🤖 CodeSnap AI

AI-Powered Code Analysis & Problem Solving Desktop Application

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

📖 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

Download: Windows Installer (.exe)
Install: Run the downloaded .exe file and follow the setup wizard
Launch: Find CodeSnap AI in your Start Menu or Desktop

🍎 macOS

Download Options:
- DMG Package (Recommended)
- ZIP Archive
Install:
- DMG: Open the file and drag CodeSnap AI to Applications
- ZIP: Extract and move to Applications folder
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

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

❓ Question Mode

Ideal for conversational programming help and learning

Switch Mode: Press Ctrl+M or click "Question Mode"
Ask Anything: Type your programming question naturally
Add Context: Optionally attach screenshots using "📷 Attach Screenshot"
Get Help: Press Ctrl+Enter for detailed AI responses
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

Switch Mode: Press Ctrl+M twice or click "MCQ Mode"
Capture Question: Use Ctrl+H to screenshot the MCQ
Analyze: Click "Analyze MCQ" to process the question
Review Answer: See the correct choice highlighted
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

Fork the repository
Create a feature branch (git checkout -b feature/amazing-feature)
Make your changes with clear, tested code
Commit with conventional commit messages
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)

🔮 Future Plans (v2.x)

💭 Ideas Under Consideration

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

🏆 Acknowledgments

Technologies & Frameworks

Electron Vite - Fast Electron development
React - UI component library
TypeScript - Type-safe development
Tailwind CSS - Utility-first CSS framework
Radix UI - Accessible UI primitives

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

Documentation: Check this README and GitHub Wiki
Issues: Report bugs or ask questions
Discussions: Community discussions

🌟 Show Support

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

📬 Connect

Kishan Patel

GitHub: @Kishan-Patel-dev
Twitter: @Kishan_Patel-dev
Linkedin: @Kishan-patel-dev

Made with ❤️ by Kishan Patel

⭐ Star this repo if you found it helpful!

⬆️ Back to Top

Name		Name	Last commit message	Last commit date
Latest commit History 22 Commits
.github		.github
.vscode		.vscode
build		build
resources		resources
src		src
web		web
.editorconfig		.editorconfig
.gitattributes		.gitattributes
.gitignore		.gitignore
.hintrc		.hintrc
.npmrc		.npmrc
.prettierignore		.prettierignore
.prettierrc.yaml		.prettierrc.yaml
README.md		README.md
bun.lock		bun.lock
electron-builder.yml		electron-builder.yml
electron.vite.config.ts		electron.vite.config.ts
eslint.config.mjs		eslint.config.mjs
notarize.js		notarize.js
package.json		package.json
postcss.config.mjs		postcss.config.mjs
tsconfig.json		tsconfig.json
tsconfig.node.json		tsconfig.node.json
tsconfig.web.json		tsconfig.web.json

Folders and files

Latest commit

History

Repository files navigation

🤖 CodeSnap AI

📖 Overview

🎯 Perfect For

🚀 Quick Start

📥 Installation

✨ Key Features

🤖 Multi-Model AI Support

🎛️ Triple Interaction Modes

🖥️ Coder Mode

❓ Question Mode

📝 MCQ Mode

🛠️ Advanced Analysis Features

🎨 Modern User Experience

⌨️ Keyboard Shortcuts

📚 Usage Guide

🖥️ Coder Mode (Default)

❓ Question Mode

📝 MCQ Mode

🔧 Development Setup

Prerequisites

Local Development

Available Scripts

Project Structure

Design System

🎨 Visual Design Principles

🏗️ Component Architecture

🤝 Contributing

🐛 Bug Reports

💡 Feature Requests

🔧 Code Contributions

Development Guidelines

📊 System Requirements

Minimum Requirements

Recommended for Best Performance

🔐 Privacy & Security

Data Handling

AI Model Security

🚀 Roadmap

🎯 Current Focus (v1.x)

🔮 Future Plans (v2.x)

💭 Ideas Under Consideration

🏆 Acknowledgments

Technologies & Frameworks

Design & Assets

Community

📞 Support & Contact

🆘 Get Help

🌟 Show Support

📬 Connect

About

Topics

Resources

Stars

Watchers

Forks

Releases

Packages

Contributors

Languages