First Name Classification

🚀 First Name Classification Model

A Transformer-based classifier to determine if a given first name is likely real or fake, useful for validating form submissions and preventing bot entries.

🚀 Quick Start

A Transformer-based classifier that checks if a provided first name is likely to be real (LABEL_1) or fake (LABEL_0). This can be helpful in validating contact form submissions, preventing bot entries, or for general name classification tasks.

✨ Features

• Checks if a provided first name is likely to be real or fake.
• Useful for validating contact form submissions and preventing bot entries.
• Can be used for general name classification tasks.

📦 Installation

1. Clone the Repository:

git clone https://github.com/Vishodi/First-Name-Classification.git

2. Set Up the Environment: Install the required packages using pip:

pip install -r requirements.txt

💻 Usage Examples

Basic Usage

from transformers import pipeline

# Replace with your model repository
model_dir = "vishodi/First-Name-Classification"

# Load the model pipeline with authentication
classifier = pipeline(
    "text-classification",
    model=model_dir,
    tokenizer=model_dir,
)

# Test the model
test_names = ["Mark", "vcbcvb", "uhyhu", "elon"]
for name in test_names:
    result = classifier(name)
    label = result[0]['label']
    score = result[0]['score']
    print(f"Name: {name} => Prediction: {label}, Score: {score:.4f}")

Output:

Name: Mark => Prediction: LABEL_1, Score: 0.9994
Name: vcbcvb => Prediction: LABEL_0, Score: 0.9985
Name: uhyhu => Prediction: LABEL_0, Score: 0.9982
Name: elon => Prediction: LABEL_1, Score: 0.9987

📚 Documentation

Project Structure

First_Name_Prediction/
├── .gitattributes
├── README.md
├── config.json
├── model.safetensors
├── requirements.txt
├── special_tokens_map.json
├── tokenizer.json
├── tokenizer_config.json
└── vocab.txt

📄 License

This project is licensed under the MIT License.

Support Us