🎓 Smart Course Builder – AI-Powered Study Plan Generator

Smart Course Builder is a personalized AI study planner built with Streamlit, powered by LLMs like Deepseek via OpenRouter, and backed by MongoDB for user authentication and data storage.

💡 Built for students who want tailored course plans, organized learning, and an intuitive interface — all in one app.

---

✨ Features

• 🔐 User Signup/Login – backed by MongoDB
• 🧠 AI-Powered Study Plan Generation – using OpenRouter + Deepseek
• 💾 Save/Edit/Delete Plans – manage your own study blueprints
• 📑 View Saved Plans in a click
• ☁️ Streamlit Cloud Deployment – runs entirely in-browser
• 🔒 Secrets secured via Replit.

---

🧰 Tech Stack

Layer	Tech
💻 Frontend	Streamlit
🧠 LLM Model	OpenRouter (Deepseek)
🗄️ Database	MongoDB Atlas
🔐 Auth	Streamlit-authenticator + MongoDB
🚀 Hosting	Streamlit Cloud / Replit

---

🚀 Getting Started

1️⃣ Clone this Repo

git clone https://github.com/roopashreerangaswamy/courseBuilderAI.git
cd smart-course-builder

2️⃣ Set Up .env File (or use Replit Secrets)

Create a .env file in the root folder:

MONGO_USERNAME=your_username
MONGO_PASSWORD=your_password
MONGO_CLUSTER=your_cluster.mongodb.net
OPENROUTER_API_KEY=your_openrouter_key

If using Replit:

• Go to Secrets (🔐 icon)
• Add each key (MONGO_USERNAME, etc.) individually.

---

3️⃣ Install Requirements

pip install -r requirements.txt

---

4️⃣ Run the App

streamlit run main.py

---

🧠 How It Works

1. User signs up and logs in
2. Enters topics, goal, and duration
3. App calls OpenRouter API → returns structured course plan
4. User can save, view, edit, or delete plans anytime

---

📦 Folder Structure

📦 smart-course-builder/
├── main.py
├── db.py
├── auth.py
├── plan_generator.py
├── requirements.txt

---

🔐 Security

• 🔒 Credentials stored using .env or Replit Secrets
• 🛡️ No passwords are stored in plain text
• 🗄️ MongoDB Atlas used with connection string hidden from codebase

---

🛠️ Future Ideas

• 📤 Export plans to PDF
• 🔔 Email reminders for each study task
• 📊 Progress tracker with charts
• 📚 Topic-specific course repositories

---

🤝 Contributing

Feel free to open issues, suggest features, or fork and enhance the UI/UX!

---

👩‍💻 Author

Rakesh J
🧑‍💻 GitHub

---