🚀 Bulk Keyword Classifier & Analyzer 📊

Overview

The Bulk Keyword Classifier & Analyzer is a powerful tool that leverages OpenAI's GPT model to classify and analyze keywords based on custom categories. Whether you're dealing with large datasets or just a few keywords, this tool helps you organize and gain insights from your data with ease.

Features

• Upload and Analyze: Upload a CSV file with keywords (and optionally,their search volumes) or enter keywords manually.
• Custom Categories: Define your own categories, including descriptions and example keywords, to tailor the classification to your needs.
• Visualization: Get visual insights into the distribution of keywords across categories using interactive charts.
• Download Results: Easily download the classification results as a CSV file for further analysis.

Technology Stack

• Streamlit: For creating the interactive web application interface.
• Pandas: For data manipulation and processing.
• OpenAI API: For keyword classification using GPT.
• Plotly: For generating interactive visualizations.
• Logging: For monitoring and troubleshooting the classification process.

Prerequisites

• Python 3.8+
• OpenAI API Key: You'll need an OpenAI API key to use the classification features.

Installation

1. Clone the repository:

   git clone https://github.com/an0te/kwclustering
   cd keyword-classifier

2. Install dependencies:

   pip install -r requirements.txt

3. Set up your OpenAI API key:

   • You'll be prompted to enter your API key within the Streamlit app.

Usage

1. Run the Streamlit app:

   streamlit run app.py

2. Upload or Enter Keywords:

   • Choose to either upload a CSV file containing your keywords or manually enter them.

3. Define Categories:

   • Specify the categories for classification, including descriptions and example keywords.

4. Analyze Keywords:

   • Click the "Analyze Keywords" button to start the classification process.

5. Visualize and Download Results:

   • View the classification results in an interactive format and download them as a CSV file.

Example Usage

1. Upload CSV File:

   • Select a CSV file with keywords.
   • Choose the columns for keywords and search volumes (optional).

2. Manual Keyword Input:

   • Enter your keywords directly into the text area.

3. Define Categories:

   • Enter category names, descriptions, and example keywords.

4. Run Analysis:

   • Start the analysis and view the results in the form of bar charts and a downloadable CSV file.

Logging

• The application logs important events, errors, and progress details to the terminal to assist with monitoring and debugging.

Contributions

Feel free to fork this repository, submit pull requests, or report issues. Contributions are always welcome!

License

This project is licensed under the MIT License.

Contact

For any questions or feedback, please reach out

---

Developed with ❤️ by Andreas