https://github.com/mohdzain98/surfmind

SurfMind is a cutting-edge Chrome extension designed to enhance your browsing experience by intelligently tracking and managing the websites you visit
https://github.com/mohdzain98/surfmind

extention fastapi llm rag react

Last synced: about 1 month ago
JSON representation

SurfMind is a cutting-edge Chrome extension designed to enhance your browsing experience by intelligently tracking and managing the websites you visit

• Host: GitHub
• URL: https://github.com/mohdzain98/surfmind
• Owner: mohdzain98
• License: mit
• Created: 2024-07-12T12:38:42.000Z (almost 2 years ago)
• Default Branch: main
• Last Pushed: 2026-04-09T17:20:41.000Z (2 months ago)
• Last Synced: 2026-04-09T18:28:19.335Z (2 months ago)
• Topics: extention, fastapi, llm, rag, react
• Language: Python
• Homepage: https://chromewebstore.google.com/detail/surfmind/ladckalplikfcplbihpgfnlkonnpehkj
• Size: 534 KB
• Stars: 0
• Watchers: 1
• Forks: 1
• Open Issues: 0
• Metadata Files:
  • Readme: README.md
  • Changelog: CHANGELOG.md
  • License: LICENSE

Awesome Lists containing this project

README

          
SurfMind - Smarter Browsing




  

    

  

  

    

  

  



### Overview

SurfMind is a Chrome extension designed to enhance your browsing experience by intelligently tracking and managing the websites you visit. Leveraging advanced AI technologies like Vector Embeddings and FAISS, SurfMind provides a seamless and efficient way to keep a detailed log of your web activity. 


### Key Features

- Automatic Website Tracking : Effortlessly logs every website you visit, along with key content, ensuring you never lose track of important information.

- AI-Powered Search : Utilize powerful AI models to search your browsing history by topic. Simply ask SurfMind about the websites you've visited related to specific topics, and it will quickly retrieve relevant results

- Streaming Progress : See retrieval, LLM response, and validation steps in real time while your answer is generated

- Local Data Storage : Keeps your data securely stored locally on user's device, ensuring privacy and security. Data is only sent to the server when user initiate a search, reducing server load and enhancing performance

- Efficient Data Management : Automatically manages and maintains your browsing history, keeping only the most recent and relevant data to avoid unnecessary storage buildup.

- User-Friendly Interface : Features an intuitive and responsive interface built with React and Bootstrap, making it easy to view and search your browsing history

### How It Works

- Tracking and Storage: As you browse, SurfMind tracks the websites you visit and stores the data locally in your browser's storage.

- Data Ingestion : When you perform a search, SurfMind ingests the locally stored data, the ingested data is converted into vector embeddings and sends it to the server for processing.

- AI-Driven Search : The server utilizes advanced AI models to analyze and retrieve the most relevant websites based on your search query.

- Efficient Retrieval : Results are promptly returned to you, providing a comprehensive overview of your browsing history related to your query.

### Benefits

- Enhanced Productivity : Quickly find websites you've previously visited without having to remember specific URLs or manually search through your history.

- Privacy-Focused : Your data remains private and secure, stored locally, and only shared when necessary for search operations.

- AI Integration : Leverage state-of-the-art AI technologies to make your browsing history more accessible and useful.

### Tech Stack

- Extension UI : React + Bootstrap (MV3 popup)

- Backend : FastAPI + Redis

- RAG : LangChain, BM25 + FAISS, Gemini/OpenAI models

### Architecture

- Extension : Tracks navigation and bookmarks, stores locally, and triggers search from the popup UI

- Backend API : Receives saved data and streams step-by-step search progress (`/api/search/stream`)

- Retrieval Pipeline : Hybrid retrieval (BM25 + FAISS), LLM response, structured parsing, and post-processing

## Onboarding

This repository includes an **auto-generated onboarding guide**

[![Onboarding](https://img.shields.io/badge/onboarding-ONBOARD.md-cyan)](./ONBOARD.md)

Generated by GNOST to help understand the codebase.

## Changelog

[![Changelog](https://img.shields.io/badge/changelog-CHANGELOG.md-blue)](./CHANGELOG.md)

## Privacy Policy



  



## License

MIT License.