📚 Learn a language while watching YouTube videos you love! 📚

Automatically captures video subtitles, builds your personal vocabulary, answers questions with AI in real-time, and enhances your language skills while you enjoy videos. - Created with Vibe Coding

English | 中文

---

Aiming to build the ultimate language learning ecosystem

🚀 Quick Start

👆 Click to Install

1. Install Déjà Vocab from the Chrome Web Store
2. Open any YouTube video
3. Hover over words in subtitles to see definitions
4. Click on words to hear pronunciation
5. Double-click to save words to your personal vocabulary
6. Use the AI assistant for any language questions

✨ Core Features

1. Interactive Vocabulary Learning

• Hover for definitions • Click for pronunciation • Double-click to save

2. Smart Video Integration

• Auto-detect saved words • Context display • One-click navigation

3. AI Language Assistant

• Contextual explanations • Language guidance • Personalized help

✨ Core Features

Special Thanks

This project leverages mem0 for memory and context management.

📥 Installation and Setup

Prerequisites

• Python 3.9 or higher
• Node.js and npm
• Chrome browser
• Google Gemini API key

Backend Setup

# Clone the repository
git clone https://github.com/Stevelonng/OpenDejaVocab.git
cd OpenDejaVocab

# Install Python dependencies
pip install -r requirements.txt

# Run database migrations
cd backend
python manage.py migrate

# Configure Google Gemini API key
# Open backend/api/gemini_views.py and backend/api/gemini_default_view.py
# Replace YOUR_API_KEY with your actual key

# Start the Django server
python manage.py runserver

Chrome Extension Setup

# Navigate to extension directory
cd extension

# Install dependencies
npm install

# Build the extension
npm run build

# Load in Chrome:
# 1. Open chrome://extensions/
# 2. Enable Developer mode
# 3. Click "Load unpacked" and select the dist folder

👥 Contributing

We welcome contributions to Déjà Vocab! Check out our contribution guidelines to get started.

⭐Star History

📜 License

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

📬 Contact

• Project Maintainer: Stevelonng
• Repository: https://github.com/Stevelonng/OpenDejaVocab
• Issues: Please use the GitHub Issues feature for bug reports and feature requests

---

If you find Déjà Vocab useful, please consider giving it a ⭐ on GitHub!