Quizlyst AI is a revolutionary learning platform that instantly transforms any content into comprehensive study materials. Whether you're a student, educator, or lifelong learner, our AI-powered system creates personalized notes, summaries, and interactive quizzes from your content in seconds.

🎓 Perfect for: Students preparing for exams, educators creating course materials, professionals upskilling, and anyone who wants to learn more efficiently.

• ⚡ Lightning Fast: Process content in under 30 seconds
• 🎯 Smart Learning: AI adapts to your learning style
• 📱 Always Available: Works on any device, anywhere
• 🌍 Global Ready: Multi-language support included
• 🔒 Privacy First: Your content stays secure

• 🎨 Modern UI: Clean, intuitive interface
• 📱 Responsive Design: Perfect on mobile & desktop
• 🌙 Dark/Light Mode: Choose your preference
• ⚡ Real-time Processing: Live progress updates

✅ Node.js 18+ installed
✅ OpenRouter API key (primary)
✅ Cohere API key (optional fallback)

# 1️⃣ Clone the repository
git clone https://github.com/Hanzlase/QuizlystAI.git
cd quizlystai

# 2️⃣ Install dependencies
npm install

# 3️⃣ Set up environment variables
cp .env.example .env
# Edit .env with your API keys

# 4️⃣ Start development server
npm run dev

# 5️⃣ Open in browser
# Navigate to http://localhost:5000

Create a .env file in the root directory:

# Required
API_KEY=your_openrouter_api_key_here

# Optional (fallback)
COHERE_KEY=your_cohere_api_key_here

# Server Configuration
PORT=5000
NODE_ENV=development

📄 Upload Files PDF, DOCX, TXT Up to 10MB

🔗 Paste URLs Articles, blogs, docs Any website

📺 YouTube Videos Educational content With transcripts

• 📝 Note Styles: Simple explanations or detailed analysis
• 🎯 Custom Instructions: "Explain like I'm 5" or "Focus on key formulas"
• 🌍 Language: Translate to your preferred language
• 📊 Quiz Settings: Choose difficulty and question count

• 📚 Study Notes: Comprehensive, markdown-formatted notes
• 📋 Smart Summary: Key concepts in 2-3 sentences
• 🎯 Interactive Quiz: Test your knowledge immediately

POST /api/content/process
Content-Type: application/json

{
  "url": "https://example.com/article",
  "type": "link",
  "mode": "simple",
  "customPrompt": "Focus on main concepts"
}

POST /api/content/upload
Content-Type: multipart/form-data

// FormData with file and processing options

POST /api/quiz/generate
Content-Type: application/json

{
  "difficulty": "medium",
  "questionCount": 10,
  "focusAreas": ["key concepts", "definitions"]
}

GET /api/health

// Response
{
  "status": "ok",
  "timestamp": "2024-01-01T00:00:00.000Z",
  "environment": "vercel",
  "hasApiKey": true
}

quizlyst-ai/
├── 📁 public/                 # Frontend assets
│   ├── 🎨 css/
│   │   └── home.css          # Responsive styling
│   ├── ⚡ js/
│   │   └── home.js           # Interactive features
│   └── 📄 home.html          # Main interface
├── 📁 uploads/               # Temp file storage (local)
├── 🚀 server.js              # Express server & API
├── 📦 package.json           # Dependencies & scripts
├── ⚙️ vercel.json            # Deployment config
└── 📖 README.md              # You are here!

• 🎯 Content Extraction: Multi-format processing with error handling
• 🤖 AI Integration: Dual API support with automatic fallback
• 📱 Responsive UI: Mobile-first design with modern CSS
• ⚡ Real-time Updates: Live processing status and progress bars
• 🌍 Translation: Built-in multi-language support

# Quick deploy
npm i -g vercel
vercel

# Set environment variables in Vercel dashboard:
# API_KEY, COHERE_KEY

# Coming soon - Docker support
FROM node:18-alpine
WORKDIR /app
COPY package*.json ./
RUN npm ci --only=production
COPY . .
EXPOSE 5000
CMD ["npm", "start"]

• Heroku: Add Procfile with web: node server.js
• Railway: Connect GitHub repo directly
• DigitalOcean: Use App Platform with Node.js preset

• Primary: Qwen 3 235B (OpenRouter) - High quality, fast
• Fallback: Command R+ (Cohere) - Reliable backup
• Timeout: 50 seconds per request
• Temperature: 0.4 (balanced creativity/accuracy)

We love contributions! Here's how to get started:

1. Check existing issues
2. Create a new issue with detailed description
3. Include steps to reproduce

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

• Follow existing code style
• Add comments for complex logic
• Test on both desktop and mobile
• Update documentation if needed

• Web Articles: ~15-30 seconds
• PDF Documents: ~20-45 seconds
• YouTube Videos: ~10-25 seconds

• Text Content: 10,000 characters (auto-truncated)
• File Size: 10MB maximum
• Quiz Questions: 1-50 per generation

• OpenRouter: Varies by plan
• Cohere: 1000 requests/month (free tier)
• Automatic Fallback: Seamless switching between APIs

# Enable detailed logging
NODE_ENV=development npm run dev

# Check API health
curl http://localhost:5000/api/health

• 🎨 Custom Themes: Personalize your interface
• 📊 Learning Analytics: Track your progress
• 👥 Team Collaboration: Share study materials
• 🔄 Batch Processing: Handle multiple files
• 📱 Mobile App: Native iOS/Android apps
• 🎓 LMS Integration: Canvas, Moodle support

• 🧠 Adaptive Learning: AI that learns your style
• 🎮 Gamification: Points, badges, leaderboards
• 🔊 Audio Generation: Text-to-speech notes
• 📝 Handwriting Recognition: Process handwritten notes
• 🌐 Offline Mode: Work without internet

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

• ✅ Commercial use allowed
• ✅ Modification allowed
• ✅ Distribution allowed
• ✅ Private use allowed
• ❌ No warranty provided