GitHub Topic Generator

It automatically generates relevant GitHub topics from GitHub URL. It uses zero-shot to analyze repository content and suggest appropriate topics based on the selected categories.

Try here : Hugging Face Space

⬇️ Sample Image ⬇️

graph TD
    subgraph Docker Container
        A[Docker: Python 3.12 Slim] --> B[Gradio Web Interface]
        B --> C[GitHub Analyzer]

        subgraph Analysis Process
            C --> D[Fetch Repository Files]
            D --> E[Extract Dependencies]
            D --> F[Process Content]
            F --> G[Zero-shot Classification<br>DeBERTa-v3]
            G --> H[Generate Topics]
        end

        H --> B
    end

    style Docker Container fill:#e6f3ff,stroke:#666
    style Analysis Process fill:#f9f9f9,stroke:#999
    style G fill:#ffe6e6,stroke:#666
    style B fill:#e6ffe6,stroke:#666

Loading

✨ Features

• Analyzes GitHub repository files (README.md, requirements.txt, .. etc.)
• Generates relevant topics based on content analysis
• Supports multiple categories including Data & AI, Scientific Research
• Provides topic recommendations based on category selection

➕ Prerequisites

• Python 3.10 or higher
• Optional : Docker, Poetry
• transformer
• aiohttp

🚩 How to use?

git clone https://github.com/Namgyu-Youn/github-topic-generator.git
cd github-topic-generator

Option 1: Using Poetry (Higly Recommended)

curl -sSL https://install.python-poetry.org | python3 - # Optional

poetry install
poetry run python app.py

Option 2: Using Docker

docker-compose up --build

Option 3: Standard Python Setup

python -m venv env

# On Windows
env\Scripts\activate
# On macOS/Linux
source env/bin/activate

pip install -r requirements.txt
python app.py

🧐 Introduction about gradio UI

1. Enter GitHub URL
2. Select the main, sub category that best matches your repository
3. Click "Generate Topics" to get your results
4. Enjoy generated topics('#')! It can be used like this.

👥 Contribution guide : CONTRIBUTING.md

Thanks for your interest. I always enjoy meaningful collaboration.
Do you have any question or bug?? Then submit ISSUE. You can also use awsome labels(🏷️).