🌐 THE FREE TRIAL ON RAILWAI END

---

✦ What is NoteStream?

NoteStream transforms any YouTube video into structured AI study notes and interactive quizzes — in seconds. No more rewinding, no more manual note-taking. Just paste a link and let AI do the work ⚠️ Currently live for 30 days.

📺 YouTube Video  ──►  🤖 AI Processing  ──►  📝 Study Notes  ──►  🧠 Quiz

---

✦ Features

📝 AI Note Extraction Powered by LLaMA 3.3 70B via Groq API. Extracts the full transcript and structures it into clean, organized study notes with sections, bullet points, and key takeaways.	🧠 Interactive Quiz Generator Auto-generates 5 multiple choice questions from your notes to test your understanding. Get instant feedback, see your score, and retake as many times as you want.
🌍 Multilingual Support Process videos in 12 languages — English, French, Arabic, Spanish, German, Italian, Portuguese, Russian, Japanese, Chinese, Korean, and Turkish.	📄 PDF Export Download your notes as a professionally formatted PDF — ready for printing, sharing, or archiving. Clean layout with proper headings and bullet points.
⚡ Lightning Fast Get full study notes in under 30 seconds. Groq's ultra-fast inference makes it feel instant compared to other AI tools.	🎨 Futuristic UI Dark deep-ocean design with animated particle canvas, glowing orbs, and smooth micro-interactions. Built to feel like a real AI product.

---

✦ Tech Stack

Layer	Technology
Frontend	HTML5 · CSS3 · Vanilla JS · Canvas API
Backend	Python · Flask · Flask-CORS
AI Model	LLaMA 3.3 70B (via Groq API)
Transcript	youtube-transcript-api
PDF Generation	ReportLab
Deployment	Railway
Font	Syne + DM Mono (Google Fonts)

---

✦ How It Works

┌─────────────────────────────────────────────────────────────────┐
│                                                                   │
│   1. 📋  Paste YouTube URL + select language                     │
│                          │                                        │
│   2. 🔍  Flask extracts video ID                                 │
│                          │                                        │
│   3. 📜  youtube-transcript-api fetches captions                 │
│                          │                                        │
│   4. 🤖  Groq / LLaMA 3.3 70B generates structured notes        │
│                          │                                        │
│   5. 📝  Notes displayed with markdown formatting                │
│                          │                                        │
│   6. 🧠  Quiz generated from notes (5 MCQ questions)             │
│                          │                                        │
│   7. 📄  Optional: export as PDF                                 │
│                                                                   │
└─────────────────────────────────────────────────────────────────┘

---

✦ Getting Started

Prerequisites

• Python 3.10+
• A Groq API Key (free)

Installation

# 1. Clone the repo
git clone https://github.com/meddadaek/notestream.git
cd notestream

# 2. Install dependencies
pip install -r requirements.txt

# 3. Create your .env file
echo "GROQ_API_KEY=your_key_here" > .env

# 4. Run the app
python app.py

Then open your browser at:

http://localhost:5000

---

✦ Environment Variables

Variable	Description	Required
GROQ_API_KEY	Your Groq API key from console.groq.com	✅ Yes

---

✦ Project Structure

notestream/
│
├── 🐍 app.py              # Flask backend — all API routes
├── 🌐 index.html          # Frontend UI
├── 🎨 style.css           # Futuristic dark UI styles
├── ⚡ script.js           # Frontend logic + quiz engine
│
├── 📦 requirements.txt    # Python dependencies
├── 🚀 Procfile            # Railway deployment config
├── 🔒 .gitignore          # Ignores .env and cache files
└── 📖 README.md           # You are here

---

✦ API Endpoints

Method	Endpoint	Description
GET	/	Serves the frontend
POST	/api/extract-notes	Extracts transcript + generates notes
POST	/api/generate-quiz	Generates quiz from notes
POST	/api/download-pdf	Returns notes as PDF file
GET	/health	Health check

---

✦ Supported Languages

🇬🇧 English · 🇫🇷 French · 🇩🇿 Arabic · 🇪🇸 Spanish · 🇩🇪 German · 🇮🇹 Italian

🇧🇷 Portuguese · 🇷🇺 Russian · 🇯🇵 Japanese · 🇨🇳 Chinese · 🇰🇷 Korean · 🇹🇷 Turkish

---

✦ Deployment

This project is deployed on Railway. To deploy your own instance:

# 1. Fork this repo
# 2. Go to railway.app → New Project → Deploy from GitHub
# 3. Select your fork
# 4. Add GROQ_API_KEY in the Variables tab
# 5. Generate a domain in Settings → Networking

---

✦ Author

Built with 💙 by AEK

 

---

✦ License

MIT License — feel free to use, modify, and share.

---