Update README.md
Browse files
README.md
CHANGED
|
@@ -9,4 +9,81 @@ app_file: app.py
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
| 12 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|
|
|
|
| 9 |
pinned: false
|
| 10 |
---
|
| 11 |
|
| 12 |
+
# Bookmark Manager App
|
| 13 |
+
|
| 14 |
+
Welcome to the Bookmark Manager App! This application allows you to upload your browser bookmarks, process them to extract useful information, and interact with them using a chatbot interface.
|
| 15 |
+
|
| 16 |
+
## **Features**
|
| 17 |
+
|
| 18 |
+
- **Upload Bookmarks**: Import an HTML file containing your browser bookmarks.
|
| 19 |
+
- **Data Extraction**: Extracts URL, website name, meta tags, and ETags from each bookmark.
|
| 20 |
+
- **Content Summarization**: Generates a brief summary of each bookmark's content using a free language model.
|
| 21 |
+
- **Vectorization and Storage**: Vectorizes the data and stores it in a FAISS vector database for efficient retrieval.
|
| 22 |
+
- **Chatbot Interaction**: Chat with your bookmarks to retrieve information based on your queries.
|
| 23 |
+
- **Bookmark Management**: Edit or delete bookmarks directly within the app.
|
| 24 |
+
- **Dead Link Detection**: Identifies and marks broken or dead links prominently.
|
| 25 |
+
- **User-Friendly Interface**: Improved interface with pleasant styling and clickable links.
|
| 26 |
+
|
| 27 |
+
## **How to Use**
|
| 28 |
+
|
| 29 |
+
1. **Upload and Process Bookmarks**
|
| 30 |
+
|
| 31 |
+
- Navigate to the **"Upload and Process Bookmarks"** tab.
|
| 32 |
+
- Click on **"Upload Bookmarks HTML File"** and select your bookmarks HTML file.
|
| 33 |
+
- Click **"Process Bookmarks"** to start processing.
|
| 34 |
+
- After processing, your bookmarks will be displayed with relevant data, and dead links will be highlighted.
|
| 35 |
+
|
| 36 |
+
2. **Chat with Your Bookmarks**
|
| 37 |
+
|
| 38 |
+
- Go to the **"Chat with Bookmarks"** tab.
|
| 39 |
+
- Enter a query in natural language to search your bookmarks.
|
| 40 |
+
- Click **"Send"** to get responses related to your query.
|
| 41 |
+
|
| 42 |
+
3. **Manage Your Bookmarks**
|
| 43 |
+
|
| 44 |
+
- Access the **"Manage Bookmarks"** tab.
|
| 45 |
+
- Click **"Refresh Bookmark List"** to view all bookmarks.
|
| 46 |
+
- To edit a bookmark:
|
| 47 |
+
- Enter the bookmark's index number.
|
| 48 |
+
- Provide a new title and/or URL.
|
| 49 |
+
- Click **"Edit Bookmark"**.
|
| 50 |
+
- To delete a bookmark:
|
| 51 |
+
- Enter the bookmark's index number.
|
| 52 |
+
- Click **"Delete Bookmark"**.
|
| 53 |
+
|
| 54 |
+
## **Requirements**
|
| 55 |
+
|
| 56 |
+
- **Python Libraries**: The app uses the following Python libraries:
|
| 57 |
+
- `gradio`
|
| 58 |
+
- `beautifulsoup4`
|
| 59 |
+
- `requests`
|
| 60 |
+
- `transformers`
|
| 61 |
+
- `sentence-transformers`
|
| 62 |
+
- `faiss-cpu`
|
| 63 |
+
- `pandas`
|
| 64 |
+
|
| 65 |
+
## **Models Used**
|
| 66 |
+
|
| 67 |
+
- **Summarization Model**: `sshleifer/distilbart-cnn-6-6` from Hugging Face Transformers.
|
| 68 |
+
- **Embedding Model**: `all-MiniLM-L6-v2` from SentenceTransformers.
|
| 69 |
+
|
| 70 |
+
## **Limitations**
|
| 71 |
+
|
| 72 |
+
- **Performance**: Processing a large number of bookmarks may be slow due to resource limitations.
|
| 73 |
+
- **Data Persistence**: The app does not save data between sessions. All data is lost when the app restarts.
|
| 74 |
+
- **Error Handling**: Basic error handling is implemented, but unexpected inputs may cause issues.
|
| 75 |
+
|
| 76 |
+
## **Acknowledgments**
|
| 77 |
+
|
| 78 |
+
- **Hugging Face**: For providing the models and platform to deploy the app.
|
| 79 |
+
- **Open-Source Libraries**: Thanks to the contributors of the libraries used in this project.
|
| 80 |
+
|
| 81 |
+
## **License**
|
| 82 |
+
|
| 83 |
+
This project is open-source and available under the MIT License.
|
| 84 |
+
|
| 85 |
+
---
|
| 86 |
+
|
| 87 |
+
Enjoy using the Bookmark Manager App!
|
| 88 |
+
|
| 89 |
Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
|