https://github.com/skupperr/ai-coding-challenge-generator
AI Coding Challenge Generator is a full-stack application that helps users improve their coding skills through daily AI-generated multiple-choice challenges, tailored by difficulty.
https://github.com/skupperr/ai-coding-challenge-generator
ai clerk fastapi javascript ollama python react sqlalchemy vite
Last synced: 3 months ago
JSON representation
AI Coding Challenge Generator is a full-stack application that helps users improve their coding skills through daily AI-generated multiple-choice challenges, tailored by difficulty.
- Host: GitHub
- URL: https://github.com/skupperr/ai-coding-challenge-generator
- Owner: skupperr
- Created: 2025-07-20T16:13:57.000Z (11 months ago)
- Default Branch: main
- Last Pushed: 2025-07-20T17:37:17.000Z (11 months ago)
- Last Synced: 2025-07-20T19:18:02.580Z (11 months ago)
- Topics: ai, clerk, fastapi, javascript, ollama, python, react, sqlalchemy, vite
- Language: Python
- Homepage:
- Size: 271 KB
- Stars: 0
- Watchers: 0
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🧠 AI Coding Challenge Generator
[](https://www.python.org/downloads/)
[](https://vitejs.dev/)
> Practice makes perfect — sharpen your coding skills with daily AI-generated MCQs.
**AI Coding Challenge Generator** is a full-stack application that helps users improve their coding skills through daily AI-generated multiple-choice challenges, tailored by difficulty.
## 🚀 Features
- 🧠 **AI-Generated Coding Questions**: Challenges are created using a local Ollama LLM model.
- 🔐 **Authentication with Clerk**: Users must log in to access the platform.
- 🎯 **Difficulty-Based Challenges**: Choose from multiple difficulty levels.
- 📊 **MCQ Format**: All challenges are multiple choice for quick practice and validation.
- 📅 **Daily Quota System**: Users can attempt a limited number of challenges per day, which resets every 24 hours.
- 🕘 **History Tracking**: All past challenges are stored in a secure SQLAlchemy database.
---
## 🛠️ Tech Stack
### Frontend
[](https://react.dev/)
[](https://developer.mozilla.org/en-US/docs/Web/JavaScript)
[](https://vitejs.dev/)
[](https://clerk.dev/)
### Backend
[](https://www.python.org/)
[](https://fastapi.tiangolo.com/)
[](https://www.sqlalchemy.org/)
[](https://clerk.dev/)
[](https://ollama.com/)
---
## 🔍 How It Works
1. **User logs in** via Clerk.
2. After login, user selects a **difficulty level** (e.g., Easy, Medium, Hard).
3. A **local Ollama model** generates a multiple-choice coding challenge.
4. The challenge is shown on the frontend and **stored in the backend** database.
5. A **daily quota** system ensures users can only attempt a limited number per day.
6. Once the quota resets, the user can generate more challenges.
---
## 💻 How to Use This Repo
### 1. Clone the repository
```bash
git clone https://github.com/skupperr/AI-Coding-Challenge-Generator.git
cd AI-Coding-Challenge-Generator
```
### 2. Set up the frontend
```bash
cd Frontend
npm install
npm run dev
```
### 3. In a new terminal, set up the backend
```bash
cd ../Backend
pip install -r requirements.txt
python server.py
```
---
## 👥 Who Is It For?
- **👨💻 Developers**: Looking to sharpen their coding skills with AI-generated practice.
- **📚 Students**: Practice MCQs before technical interviews or exams.
- **🧠 Lifelong Learners**: Anyone who wants a quick daily coding brain-teaser.
---
## 📁 Project Structure
```
AI-Coding-Challenge-Generator/
├── Backend/ # FastAPI backend
│ ├── src/
│ │ ├── routes/
│ │ ├── models/
│ │ ├── database/
│ │ ├── ai_generator.py
│ │ ├── app.py
│ │ ├── utils.py
│ │ └── .env
│ ├── server.py
│ └── requirements.txt
│
├── Frontend/
│ ├── src/
│ │ ├── auth/
│ │ ├── challenges/
│ │ ├── history/
│ │ ├── layout/
│ │ ├── utils/
│ │ ├── App.css
│ │ ├── index.css
│ │ ├── main.jsx
│ │ ├── App.jsx
│ ├── public/
│ ├── .env
│ ├── index.html
│ └── package.json
│
└── README.md
```
## 📬 Contact
Created with ❤️ by [Asif U. Ahmed](https://github.com/skupperr)
[Report Bug](https://github.com/skupperr/AI-Coding-Challenge-Generator/issues) · [Request Feature](https://github.com/skupperr/AI-Coding-Challenge-Generator/issues)