Ecosyste.ms: Awesome

An open API service indexing awesome lists of open source software.

Awesome Lists | Featured Topics | Projects

https://github.com/geeknik/ai-tab-grouper

Automatically groups your browser tabs using advanced text analysis algorithms
https://github.com/geeknik/ai-tab-grouper

ai algorithms analysis brave extension firefox privacy-first security-first-principles tabs text

Last synced: 1 day ago
JSON representation

Automatically groups your browser tabs using advanced text analysis algorithms

Host: GitHub
URL: https://github.com/geeknik/ai-tab-grouper
Owner: geeknik
License: gpl-3.0
Created: 2024-09-17T14:57:19.000Z (4 months ago)
Default Branch: main
Last Pushed: 2024-11-16T02:37:15.000Z (2 months ago)
Last Synced: 2025-01-07T16:54:26.708Z (8 days ago)
Topics: ai, algorithms, analysis, brave, extension, firefox, privacy-first, security-first-principles, tabs, text
Language: JavaScript
Homepage:
Size: 1.03 MB
Stars: 4
Watchers: 1
Forks: 0
Open Issues: 1
Metadata Files:
- Readme: README.md
- License: LICENSE

Awesome Lists containing this project

README

# AI Tab Grouper

AI Tab Grouper is a Brave extension that automatically organizes your tabs into groups using AI-powered text analysis algorithms.

![CleanShot 2024-09-18 at 11 34 26@2x](https://github.com/user-attachments/assets/462b125e-55a8-477b-b0b1-7064f369d7bb)

## Features

- Automatically groups related tabs using advanced text analysis
- Supports multiple grouping algorithms:
- TF-IDF (Term Frequency-Inverse Document Frequency)
- BM25 (Best Matching 25)
- Keyphrase Extraction
- Customizable settings for grouping behavior
- Ignores pinned tabs, ensuring they remain untouched
- Periodic automatic grouping with adjustable intervals
- Manual grouping option
- Persists grouping intelligence across browser sessions
- Respects user privacy by performing all processing locally

## Installation

1. Clone this repository or download the source code
2. Open Brave and navigate to `brave://extensions/`
3. Enable "Developer mode" in the top right corner
4. Click "Load unpacked" and select the directory containing the extension files

## Usage

Once installed, the extension will automatically start grouping your non-pinned tabs based on your settings. You can access the extension's popup by clicking on its icon in the Chrome toolbar. From there, you can:

- Manually trigger tab grouping
- View statistics about your current tabs and groups
- Access the settings page

### Pinned Tabs

Pinned tabs are always ignored by the extension. They will not be unpinned or included in any grouping operations.

## Settings

In the options page, you can customize:

- Grouping Algorithm: Choose between TF-IDF, BM25, or Keyphrase Extraction
- Similarity Threshold: Adjust how similar tabs need to be to be grouped together
- Automatic Grouping Interval: Set how often the extension should attempt to group tabs
- Maximum Group Name Length: Limit the length of automatically generated group names
- BM25 Parameters (k1 and b): Fine-tune the BM25 algorithm if selected

To access the settings, right-click the extension icon and select "Options", or use the "Open Settings" button in the popup.

![CleanShot 2024-09-18 at 11 35 11@2x](https://github.com/user-attachments/assets/e093775f-0e2d-4a45-b37b-4936e0b4aa2f)

## Algorithms

### TF-IDF (Term Frequency-Inverse Document Frequency)
Evaluates how important a word is to a document in a collection of documents. It's effective for content-based grouping.

### BM25 (Best Matching 25)
An advanced ranking function used by search engines. It can provide more nuanced grouping based on term importance and document length.

### Keyphrase Extraction
Identifies the most important phrases in the tab content, which can be effective for grouping tabs with similar key topics.

## Privacy

[This extension does not collect or transmit any personal data](PRIVACY.md). All text analysis and grouping operations are **performed locally in your browser**.

## Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

## License

[GPLv3](LICENSE)

## Troubleshooting

If you encounter any issues:

1. Check the extension's options to ensure settings are configured correctly.
2. Try manually triggering the grouping from the popup.
3. Disable and re-enable the extension.
4. If problems persist, please open an issue on this repository with a detailed description of the problem and your Brave version.

## Future Enhancements

- Firefox Support
- Support for custom grouping algorithms
- Advanced group naming options
- Integration with browser sync for cross-device grouping
- Performance optimizations for handling large numbers of tabs