https://github.com/deltartificial/bookmarks-classification-ts
Automatically organize and classify your browser bookmarks using AI.
https://github.com/deltartificial/bookmarks-classification-ts
ai bookmarks chrome classification deepseek firefox manager openai sort ts typescript
Last synced: 4 months ago
JSON representation
Automatically organize and classify your browser bookmarks using AI.
- Host: GitHub
- URL: https://github.com/deltartificial/bookmarks-classification-ts
- Owner: deltartificial
- Created: 2025-02-09T20:28:41.000Z (over 1 year ago)
- Default Branch: main
- Last Pushed: 2025-02-09T23:58:43.000Z (over 1 year ago)
- Last Synced: 2025-04-11T18:08:58.844Z (about 1 year ago)
- Topics: ai, bookmarks, chrome, classification, deepseek, firefox, manager, openai, sort, ts, typescript
- Language: TypeScript
- Homepage:
- Size: 562 KB
- Stars: 2
- Watchers: 1
- Forks: 1
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# Bookmark Organizer 📌
Automatically organize and classify your browser bookmarks using AI.
## Features
- Supports Chrome and Firefox bookmarks
- Multiple AI models supported (OpenAI and DeepSeek)
- Automatically creates meaningful folder structures
- Optional folder grouping to limit the number of top-level folders
- Adds relevant tags to bookmarks
## Installation
```bash
# Clone the repository
git clone [repo-url]
cd bookmarks-classification-ts
# Install dependencies
bun install
```
## Usage
1. Export your bookmarks from Chrome or Firefox as HTML
2. Place the exported HTML file(s) in the `data` folder
3. Run the organizer using one of these methods:
```bash
# Using environment variable
export AI_API_KEY='your-api-key'
export AI_MODEL='openai' # or 'deepseek'
bun run organize
# Or directly with the command
bun run organize --api-key 'your-api-key' --model openai
# Specify browser (chrome is default)
bun run organize --browser firefox --model deepseek
# Limit the number of top-level folders (will group similar folders together)
bun run organize --max-folders 10
# Add custom instructions for bookmark classification
bun run organize --prompt "Focus on technical and professional categories"
# Add custom instructions for folder grouping
bun run organize --group-prompt "Prioritize development-related categories"
# Use all options
bun run organize --api-key 'your-api-key' --model openai --browser chrome --max-folders 15 --prompt "Focus on work-related categories" --group-prompt "Create industry-specific groups"
```
The organized bookmarks will be saved in `data/output` with a timestamp in the filename.
## Requirements
- Bun runtime
- API key (OpenAI or DeepSeek)
- Chrome or Firefox bookmarks exported as HTML
## Supported AI Models
- OpenAI (GPT-3.5-turbo)
- DeepSeek (deepseek-chat)