UPLOAD_GUIDE.md

Steel Material Classification Model Upload Guide

Step 1: Get Hugging Face Token

1. Go to https://huggingface.co/settings/tokens
2. Click "New token"
3. Give it a name (e.g., "model-upload-token")
4. Select "Write" role
5. Copy the token

Step 2: Login to Hugging Face

huggingface-cli login
# Enter your token when prompted

Step 3: Create Model Repository

huggingface-cli repo create steel-material-classifier --type model

Step 4: Upload Model

# Clone the repository
git clone https://huggingface.co/YOUR_USERNAME/steel-material-classifier
cd steel-material-classifier

# Copy all files from model_v24 directory
# Then commit and push
git add .
git commit -m "Initial commit: Steel material classification model"
git push

Alternative: Direct Upload

# From the model_v24 directory
huggingface-cli upload YOUR_USERNAME/steel-material-classifier . --include "*.json,*.safetensors,*.pkl,*.md,*.txt,*.py"

Files to Upload

Required Files:

• ✅ config.json
• ✅ model.safetensors
• ✅ tokenizer.json
• ✅ tokenizer_config.json
• ✅ special_tokens_map.json
• ✅ label_mapping.json

Optional Files:

• ✅ classifier.pkl
• ✅ label_embeddings.pkl
• ✅ label_embeddings.pkl.backup

Documentation Files:

• ✅ README.md
• ✅ requirements.txt
• ✅ inference.py
• ✅ preprocessor.py
• ✅ model_card.md
• ✅ usage.md

Model Information

• Model Name: steel-material-classifier
• Base Model: XLM-RoBERTa
• Task: Sequence Classification
• Labels: 66 steel industry materials
• Languages: Korean, English
• Model Size: ~1GB

Usage After Upload

from transformers import AutoTokenizer, AutoModelForSequenceClassification
import torch

# Load model
model_name = "YOUR_USERNAME/steel-material-classifier"
tokenizer = AutoTokenizer.from_pretrained(model_name)
model = AutoModelForSequenceClassification.from_pretrained(model_name)

# Predict
text = "철광석을 고로에서 환원하여 선철을 제조하는 과정"
inputs = tokenizer(text, return_tensors="pt", truncation=True, max_length=512)

with torch.no_grad():
    outputs = model(**inputs)
    predictions = torch.nn.functional.softmax(outputs.logits, dim=-1)
    predicted_class = torch.argmax(predictions, dim=1).item()

label = model.config.id2label[predicted_class]
confidence = predictions[0][predicted_class].item()
print(f"Predicted: {label} (Confidence: {confidence:.4f})")