AI LeetCode Generator

A modern, AI-powered coding problem generator built with Astro, Svelte, and Python Flask. Generate custom LeetCode-style problems with intelligent difficulty scaling, topic selection, and an integrated code editor.

🚀 Features

Frontend (Astro + Svelte)

• 🎯 Interactive Problem Generator: Select difficulty, topics, and custom requirements
• 💻 Integrated Code Editor: Monaco Editor with syntax highlighting for multiple languages
• 🧪 Test Runner: Execute and validate solutions with detailed feedback
• 🌙 Dark/Light Theme: Responsive design with theme toggle
• 📱 Mobile Responsive: Works seamlessly across all devices
• ⚡ Fast Performance: Astro's static site generation with Svelte islands

Backend (Python Flask)

• 🤖 AI-Powered Generation: Advanced algorithms for problem creation using multiple AI models
• 📊 Difficulty Scaling: Intelligent problem complexity adjustment
• 💾 Caching System: Redis-based caching for improved performance
• 🔒 Rate Limiting: Protection against abuse with Redis-backed rate limiting
• 📈 Analytics: Problem generation tracking and metrics
• ⚡ Code Execution: Integrated Judge0 API for code testing and validation
• 🏗️ Unified Architecture: Centralized service management with database abstraction

🛠️ Tech Stack

Frontend

• Astro 4.0 - Static site generator with islands architecture
• Svelte - Reactive UI components
• Tailwind CSS - Utility-first CSS framework
• Monaco Editor - VS Code-powered code editor
• TypeScript - Type-safe development

Backend

• Python Flask - Lightweight web framework
• MongoDB - Document database for problem storage
• Redis - Caching and session management
• AI Models - Multiple AI providers (OpenAI, Unsloth) for problem generation
• Judge0 API - Code execution and testing service
• Flask-CORS - Cross-origin resource sharing
• Flask-Limiter - Rate limiting with Redis backend

📦 Installation

Prerequisites

• Node.js 18+ and npm
• Python 3.8+
• MongoDB
• Redis
• AI API keys (OpenAI recommended)
• Judge0 API key (for code execution)

Frontend Setup

cd frontend
npm install
npm run dev

The frontend will be available at http://localhost:4321

Backend Setup

cd backend
python -m venv venv
source venv/bin/activate  # On Windows: venv\Scripts\activate
pip install -r requirements.txt

# Copy environment variables
cp .env.example .env
# Edit .env with your configuration

python app.py

The backend API will be available at http://localhost:5000

⚙️ Configuration

Frontend Environment Variables

Create a .env file in the frontend directory:

BACKEND_URL=http://localhost:5000
PUBLIC_APP_NAME="AI LeetCode Generator"

Backend Environment Variables

Create a .env file in the backend directory:

# MongoDB Configuration
MONGO_URI=mongodb://localhost:27017/leetcode_generator

# Redis Configuration
REDIS_URI=redis://localhost:6379

# Judge0 API Configuration
JUDGE0_API_KEY=your_judge0_api_key_here
JUDGE0_API_URL=https://judge0-ce.p.rapidapi.com

# Unsloth AI Model Configuration
UNSLOTH_MODEL_PATH=unsloth/llama-2-7b-chat-bnb-4bit
UNSLOTH_MAX_SEQ_LENGTH=2048
UNSLOTH_DTYPE=float16
UNSLOTH_LOAD_IN_4BIT=true

# Flask Configuration
FLASK_ENV=development
FLASK_DEBUG=true
SECRET_KEY=your_secret_key_here_change_in_production

# Rate Limiting
RATE_LIMIT_STORAGE_URL=redis://localhost:6379
RATE_LIMIT_DEFAULT=100 per hour

# CORS Configuration
CORS_ORIGINS=http://localhost:3000,http://localhost:4321

# Logging
LOG_LEVEL=INFO
LOG_FILE=app.log

🎮 Usage

Generating Problems

1. Select Difficulty: Choose from Easy, Medium, or Hard
2. Pick a Topic: Select from 20+ programming topics or leave blank
3. Custom Requirements: Add specific requirements or constraints
4. Generate: Click "Generate Problem" to create a new challenge

Coding Interface

1. Language Selection: Choose from JavaScript, Python, Java, C++, C#, Go, or Rust
2. Code Editor: Write your solution in the Monaco editor
3. Run Tests: Execute your code against test cases
4. View Results: See detailed feedback and performance metrics
5. Solution: Access reference solutions when needed

API Endpoints

Generate Problem

POST /api/problems/generate-problem
Content-Type: application/json

{
  "topic": "Array",
  "difficulty": "medium",
  "additional_requirements": "Focus on two-pointer technique"
}

Submit Solution

POST /api/submissions/submit
Content-Type: application/json

{
  "problem_id": "problem-id",
  "code": "function solution() { ... }",
  "language": "javascript"
}

🏗️ Architecture

Frontend Architecture

frontend/
├── src/
│   ├── components/          # Svelte components
│   │   ├── LeetCodeGenerator.svelte
│   │   └── CodeEditor.svelte
│   ├── layouts/             # Astro layouts
│   ├── pages/               # Astro pages and API routes
│   │   ├── index.astro
│   │   └── api/generate.js
│   └── styles/              # Global styles
├── astro.config.mjs         # Astro configuration
├── tailwind.config.mjs      # Tailwind configuration
└── package.json

Backend Architecture

backend/
├── app/
│   ├── models/              # Database models
│   │   ├── problem.py
│   │   └── submission.py
│   ├── routes/              # API routes
│   │   ├── problems.py
│   │   ├── submissions.py
│   │   ├── ai.py
│   │   ├── code_exec.py
│   │   └── health.py
│   ├── services/            # Business logic services
│   └── database.py          # Database configuration
├── db/                      # Database management
│   └── __init__.py          # Unified database manager
├── services/                # Core services
│   ├── ai_service.py        # AI service integration
│   ├── code_exec.py         # Code execution service
│   └── problem_gen.py       # Problem generation service
├── models/                  # AI models
│   ├── llama_model.py
│   └── mistral_model.py
├── utils/                   # Utility functions
│   ├── formatters.py        # Response formatting
│   ├── validators.py        # Input validation
│   └── prompt_templates.py  # AI prompt templates
├── app.py                   # Flask application
└── requirements.txt

🧪 Testing

Frontend Testing

cd frontend
npm run test
npm run test:e2e

Backend Testing

cd backend
python -m pytest tests/

🚀 Deployment

Frontend (Vercel/Netlify)

npm run build
# Deploy dist/ folder

Backend (Docker)

docker build -t leetcode-generator-backend .
docker run -p 5000:5000 leetcode-generator-backend

🤝 Contributing

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

📝 License

This project is licensed under the MIT License - see the LICENSE file for details.

🙏 Acknowledgments

• Astro Team - For the amazing static site generator
• Svelte Team - For the reactive UI framework
• Monaco Editor - For the powerful code editor
• OpenAI - For AI-powered problem generation
• LeetCode - For inspiration and problem format

📞 Support

If you have any questions or need help:

• 📧 Email: support@leetcodegenerator.com
• 💬 Discord: Join our community
• 🐛 Issues: GitHub Issues

---

Happy Coding! 🎉