Ecosyste.ms: Awesome
An open API service indexing awesome lists of open source software.
https://github.com/an0te/kwclustering
This tool allows you to classify and analyze keywords using OpenAI's GPT model.
https://github.com/an0te/kwclustering
ai python seo streamlit
Last synced: about 1 month ago
JSON representation
This tool allows you to classify and analyze keywords using OpenAI's GPT model.
- Host: GitHub
- URL: https://github.com/an0te/kwclustering
- Owner: an0te
- Created: 2024-08-12T12:41:26.000Z (4 months ago)
- Default Branch: main
- Last Pushed: 2024-08-12T14:35:58.000Z (4 months ago)
- Last Synced: 2024-08-23T15:01:46.899Z (4 months ago)
- Topics: ai, python, seo, streamlit
- Language: Python
- Homepage:
- Size: 11.7 KB
- Stars: 1
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
Awesome Lists containing this project
README
# 🚀 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**:
```bash
git clone https://github.com/an0te/kwclustering
cd keyword-classifier
```
2. **Install dependencies**:
```bash
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**:
```bash
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