Skip to content

Latest commit

Β 

History

20 Commits

Folders and files

NameName
Last commit message
Last commit date
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ€– BrowserBuddy AI

Your Intelligent Browsing Assistant Powered by AI


🌟 What is BrowserBuddy AI?

BrowserBuddy AI is a powerful Chrome extension that uses cutting-edge AI (Groq/Llama 3.3) to supercharge your browsing experience. Say goodbye to tab chaos, content overload, and repetitive tasks!

🎯 Perfect for:

  • πŸ“š Students researching for assignments
  • πŸ’Ό Professionals managing multiple projects
  • πŸ”¬ Researchers reading complex papers
  • ✍️ Content creators gathering information
  • πŸŽ“ Job seekers optimizing resumes

✨ Features

1. πŸ—‚οΈ Smart Tab Manager

AI-powered tab organization that actually works!

  • πŸ€– AI detects duplicate and similar tabs
  • ⚑ Quick Scan mode (instant, rule-based)
  • πŸ“Š Tab usage statistics
  • πŸ—‘οΈ One-click bulk cleanup
  • 🎯 Confidence scoring

2. πŸ“ Content Simplifier

Make any content easier to understand!

  • 🧸 ELI5 mode (Explain Like I'm 5)
  • 😊 Simple mode (general audience)
  • πŸ“š Medium mode (balanced detail)
  • πŸ”¬ Technical mode (expert level)
  • πŸ“‹ Copy simplified text
  • πŸ“„ Full page summarization

3. πŸ“– Reading Mode

Distraction-free reading experience!

  • πŸŒ™ Dark/Light theme toggle
  • πŸ”€ Adjustable font size (12-24px)
  • 🚫 Ad and clutter removal
  • ✨ Clean, focused layout
  • πŸ“± Works on articles, blogs, news

4. πŸŽ₯ YouTube Summary Mode

Quick, distraction-free video insights!

  • πŸ“ Instant AI-generated summaries
  • ⏱️ Key points with timestamps
  • πŸ“Œ Bullet-point highlights for fast review
  • 🧠 Extracts main ideas & takeaways
  • πŸ“± Works on tutorials, lectures, podcasts, news, and more

5. πŸ”– Smart Bookmarks

AI organizes your bookmarks automatically!

  • πŸ€– Auto-categorization (12 categories)
  • 🏷️ Smart tag generation
  • πŸ” Intelligent search
  • πŸ“ Category filtering
  • ⚑ One-click bookmark saving

6. πŸ“„ Resume Optimizer

Get that job with ATS-friendly resumes!

  • 🎯 Keyword extraction from job descriptions
  • πŸ“Š Match score calculation (0-100%)
  • πŸ’‘ AI improvement suggestions
  • πŸ“₯ Generate ATS-friendly .docx templates
  • βœ… Highlight matched/missing keywords

7. βš™οΈ Settings & Customization

Complete control over your experience!

  • 🎨 Theme switching (Auto/Light/Dark)
  • πŸ”€ Font size preferences
  • 🎚️ Feature toggles
  • ⌨️ Keyboard shortcuts
  • πŸ”’ Privacy controls

πŸš€ Quick Start

Installation:

Manual Installation

  1. Download the latest release from Releases
  2. Unzip the file
  3. Open Chrome β†’ chrome://extensions/
  4. Enable "Developer mode" (top right)
  5. Click "Load unpacked"
  6. Select the unzipped folder
  7. πŸŽ‰ Done! Click the extension icon to start

πŸ› οΈ Tech Stack

Frontend (Extension)

  • βš›οΈ React 18 with Vite
  • 🎨 CSS3 with Glassmorphism
  • πŸ”Œ Chrome Extension API (Manifest V3)
  • ✨ Smooth animations and transitions

Backend

  • 🟒 Node.js + Express.js
  • πŸƒ MongoDB (optional, works without)
  • πŸ€– Groq AI (Llama 3.3-70b-versatile)
  • πŸ”’ RESTful API architecture

AI Integration

  • Provider: Groq (FREE tier)
  • Model: llama-3.3-70b-versatile
  • Limit: ~14,400 requests/day
  • Features: All features have non-AI fallbacks


πŸ—οΈ Project Structure

browserbuddy-ai/
β”œβ”€β”€ extension/              # Chrome Extension
β”‚   β”œβ”€β”€ public/
β”‚   β”‚   β”œβ”€β”€ manifest.json  # Extension config
β”‚   β”‚   β”œβ”€β”€ background.js  # Background service worker
β”‚   β”‚   β”œβ”€β”€ content.js     # Content scripts
β”‚   β”‚   └── icons/         # Extension icons
β”‚   β”œβ”€β”€ src/
β”‚   β”‚   β”œβ”€β”€ components/    # React components
β”‚   β”‚   β”œβ”€β”€ App.jsx        # Main app
β”‚   β”‚   └── App.css        # Styles
β”‚   └── package.json
β”‚
β”œβ”€β”€ backend/               # Express API
β”‚   β”œβ”€β”€ routes/           # API routes
β”‚   β”œβ”€β”€ controllers/      # Business logic
β”‚   β”œβ”€β”€ models/          # MongoDB schemas
β”‚   β”œβ”€β”€ utils/           # Helper functions
β”‚   └── server.js        # Entry point
β”‚
β”œβ”€β”€ landing-page/        # Marketing website
β”‚   └── (deployed separately)
β”‚
└── docs/               # Documentation
    β”œβ”€β”€ README.md
    β”œβ”€β”€ USER_GUIDE.md
    β”œβ”€β”€ DEVELOPER.md
    β”œβ”€β”€ API.md
    └── SETUP.md

πŸ”§ Development Setup

See SETUP.md for detailed instructions.

Quick Start:

# Clone repository
git clone https://github.com/yourusername/browserbuddy-ai.git
cd browserbuddy-ai

# Backend setup
cd backend
npm install
cp .env.example .env
# Add your GROQ_API_KEY to .env
npm run dev

# Extension setup (new terminal)
cd extension
npm install
npm run build

# Load extension in Chrome
# chrome://extensions/ β†’ Load unpacked β†’ Select extension/dist

🌐 API Documentation

See API.md for complete API reference.

Base URL: http://localhost:5000/api

Endpoints:

  • /tabs/* - Tab management
  • /simplify/* - Content simplification
  • /bookmarks/* - Bookmark management
  • /settings/* - User settings
  • /resume/* - Resume optimization

🀝 Contributing

We love contributions! See DEVELOPER.md for guidelines.

Quick steps:

  1. Fork the repo
  2. Create a feature branch (git checkout -b feature/AmazingFeature)
  3. Commit changes (git commit -m 'Add AmazingFeature')
  4. Push to branch (git push origin feature/AmazingFeature)
  5. Open a Pull Request

πŸ“„ License

This project is released for general public use. You are free to use, copy, modify, and distribute this project for personal or commercial purposes. No formal license is required..


πŸ™ Acknowledgments

  • Groq for providing free, fast AI inference
  • Chrome Extension API for the powerful platform
  • MongoDB Atlas for free database hosting
  • Vercel for landing page hosting
  • Open Source Community for amazing libraries

πŸ“ž Support


πŸ—ΊοΈ Roadmap

  • Chrome Web Store publication
  • Firefox extension port
  • More AI models support
  • Cloud sync for settings
  • Mobile companion app
  • Team collaboration features

⭐ Star History

If you find this project useful, please consider giving it a star!

Star History Chart


πŸ’– Support the Project

If BrowserBuddy AI helps you, consider:

  • ⭐ Starring the repository
  • πŸ› Reporting bugs
  • πŸ’‘ Suggesting features
  • πŸ“’ Sharing with friends

Made with ❀️ by [Rishabh Singh]
College Final Year Project | 2026


πŸ€– "Stop browsing. Start thriving." - BrowserBuddy AI

Releases

Packages

Contributors

Languages