🚀 Let's Bunk – AI-Powered Tech Event Finder

Let's Bunk is an AI-powered web application that helps students discover the best tech events, hackathons, workshops, and competitions—all in one place.
Instead of boring manual searching, Let's Bunk uses Machine Learning to recommend events based on student interests.

---

✨ Features

• 🤖 AI-Based Event Recommendations
• 🌐 Fetches events from 10+ real platforms
• 🎯 Personalized results based on interests (AI, Web, Blockchain, etc.)
• 🏆 Focus on free, online & certificate-providing events
• 📊 Event quality scoring (Hackathons > Workshops > Competitions)
• ⚡ Fallback smart logic when AI data is limited

---

🔍 Event Sources

Let's Bunk collects real-time or scraped data from:

• Devpost (Hackathons)
• Unstop (Competitions)
• HackerEarth
• Kaggle
• Analytics Vidhya
• TopCoder
• GitHub Events
• Google Developers
• Microsoft Developer Events
• FreeCodeCamp
• TechGig

(High-quality mock events are used only when real data is insufficient)

---

🧠 AI & ML Tech Stack

• TF-IDF Vectorization for text understanding
• Cosine Similarity for recommendations
• KMeans Clustering for event grouping
• Scikit-learn, Pandas, NumPy
• Smart scoring based on:
  • Interests match
  • Online / Free events
  • Certificates
  • Event type (Hackathon, Workshop, etc.)

---

🛠 Tech Stack

Backend

• Python
• Flask
• Scikit-learn
• BeautifulSoup
• Requests

Frontend

• HTML
• CSS
• JavaScript (Flask Templates)

---

📁 Project Structure

├── app.py
├── templates/
│   ├── index.html
│   ├── events.html
│   └── ai_recommendations.html
├── ai_models/
│   ├── tfidf_vectorizer.pkl
│   ├── kmeans_model.pkl
│   └── scaler.pkl
├── static/
├── .env
└── README.md

---

▶️ How to Run Locally

1. Clone the repository

git clone https://github.com/Atibali/lets-bunk.git
cd lets-bunk

2. Install dependencies

pip install -r requirements.txt

3. Run the app

python app.py

4. Open browser:

http://localhost:5000

---

📡 API Endpoints

Endpoint	Description
/api/events	Get all events
/api/ai-recommend	AI-based recommendations
/api/event-stats	Event statistics
/api/sources	Event sources list

---

🎯 Target Users

• College students
• Hackathon hunters
• Tech learners
• Developers looking for certificates & competitions

---

🚧 Current Status

• ✅ Core features working
• ✅ AI recommendation engine implemented
• 🔄 UI improvements in progress
• 🔮 Future: Login, bookmarks, notifications

---

🌟 Future Enhancements

• User accounts & profiles
• Event reminders
• Location-based filtering
• Mobile app version
• Better AI personalization

---

🧑‍💻 Author

Built with ❤️ by Students, for Students Project Name: Let's Bunk

---

⚠️ Disclaimer

This project uses public data and web scraping for educational purposes only.