Hugging Face's logo

SamanthaStorm
/
intentanalyzer

Text Classification
Transformers
PyTorch
Safetensors
English
distilbert
intent-detection
communication-analysis
multi-label-classification
psychology
nlp
Eval Results
Model card Files Community
1
intentanalyzer / README.md
SamanthaStorm's picture
SamanthaStorm
Upload IntentAnalyzer v1.0 - Multi-Label Communication Intent Detection Model
4a965dc verified
preview code
|
raw
history blame contribute delete
7.48 kB
metadata
language: en
license: mit
tags:
  - text-classification
  - intent-detection
  - communication-analysis
  - multi-label-classification
  - psychology
  - nlp
  - transformers
datasets:
  - custom
metrics:
  - f1: 0.77
  - precision: 0.95
  - recall: 0.92
model-index:
  - name: IntentAnalyzer
    results:
      - task:
          type: text-classification
          name: Multi-Label Intent Detection
        dataset:
          type: custom
          name: Communication Intent Dataset
        metrics:
          - type: f1_macro
            value: 0.77
          - type: f1_trolling
            value: 0.94
          - type: f1_constructive
            value: 0.99
widget:
  - text: You're just a stupid liberal, so your opinion doesn't matter
    example_title: Manipulative + Dismissive
  - text: I understand your concerns, but here's why I disagree
    example_title: Constructive Communication
  - text: Whatever, I don't care about this anymore
    example_title: Dismissive Behavior
  - text: I CAN'T BELIEVE you would say that to me!!!
    example_title: Emotionally Reactive
  - text: If you really loved me, you would support this
    example_title: Manipulative Behavior

IntentAnalyzer: Multi-Label Communication Intent Detection

Model Description

IntentAnalyzer is a state-of-the-art multi-label text classification model designed to detect underlying intentions in human communication. Built on DistilBERT architecture, this model can simultaneously identify multiple intent categories with high precision, helping understand the psychological and communicative patterns behind text.

Supported Intent Categories

The model detects 6 different intent categories (multi-label):

  1. 🧌 Trolling - Deliberately provocative or disruptive communication
  2. 🚫 Dismissive - Shutting down conversation or avoiding engagement
  3. 🎭 Manipulative - Using emotional coercion, guilt, or pressure tactics
  4. 🌋 Emotionally Reactive - Overwhelmed by emotion, not thinking clearly
  5. ✅ Constructive - Good faith engagement and dialogue
  6. ❓ Unclear - Ambiguous intent that's difficult to determine

Performance Metrics

Overall Performance

  • F1 Score (Macro): 0.77
  • Multi-label Classification: Supports simultaneous detection of multiple intents

Per-Category Performance

  • Trolling: F1=0.943 (P=0.976, R=0.911)
  • Dismissive: F1=0.850 (P=0.964, R=0.761)
  • Manipulative: F1=0.907 (P=0.867, R=0.951)
  • Emotionally Reactive: F1=0.939 (P=0.931, R=0.947)
  • Constructive: F1=0.989 (P=0.978, R=1.000)
  • Unclear: F1=0.000 (Expected - ambiguous by design)

Usage 

import torch
from transformers import AutoTokenizer, AutoModel
import torch.nn as nn

# Define the model architecture
class MultiLabelIntentClassifier(nn.Module):
    def __init__(self, model_name, num_labels):
        super().__init__()
        self.bert = AutoModel.from_pretrained(model_name)
        self.dropout = nn.Dropout(0.3)
        self.classifier = nn.Linear(self.bert.config.hidden_size, num_labels)

    def forward(self, input_ids, attention_mask):
        outputs = self.bert(input_ids=input_ids, attention_mask=attention_mask)
        pooled_output = outputs.last_hidden_state[:, 0]
        pooled_output = self.dropout(pooled_output)
        logits = self.classifier(pooled_output)
        return logits

# Load model and tokenizer
model_name = "SamanthaStorm/intentanalyzer"
tokenizer = AutoTokenizer.from_pretrained("distilbert-base-uncased")

# Load the custom model (you'll need to download the .pth file)
model = MultiLabelIntentClassifier("distilbert-base-uncased", 6)
# model.load_state_dict(torch.load('pytorch_model.bin'))

# Intent categories
intent_categories = ['trolling', 'dismissive', 'manipulative', 'emotionally_reactive', 'constructive', 'unclear']

def predict_intent(text, threshold=0.5):
    inputs = tokenizer(text, return_tensors="pt", truncation=True, padding=True, max_length=128)

    with torch.no_grad():
        outputs = model(inputs['input_ids'], inputs['attention_mask'])
        probabilities = torch.sigmoid(outputs).numpy()[0]

    # Return predictions above threshold
    predictions = {}
    for i, category in enumerate(intent_categories):
        prob = probabilities[i]
        if prob > threshold:
            predictions[category] = prob

    return predictions

# Example usage
text = "You're just being emotional and can't think rationally"
intents = predict_intent(text)
print("Detected intents:", intents)

Training Data

The model was trained on a carefully curated dataset of 1,226 examples with:

  • Single-label examples: Clear instances of each intent type
  • Multi-label examples: Realistic scenarios with multiple simultaneous intents
  • Balanced distribution: Proper representation across all categories
  • Diverse contexts: Personal, professional, online, and social interactions

Model Architecture

  • Base Model: DistilBERT (distilbert-base-uncased)
  • Task: Multi-label text classification
  • Classes: 6 intent categories
  • Loss Function: BCEWithLogitsLoss (binary cross-entropy for multi-label)
  • Max Sequence Length: 128 tokens
  • Training Examples: 1,226 high-quality examples

Applications

Communication Analysis

  • Customer Service: Identify frustrated or manipulative customers
  • Social Media Monitoring: Detect trolling and constructive engagement
  • Relationship Counseling: Understand communication patterns
  • Content Moderation: Flag problematic intent patterns

Research Applications

  • Psychology: Study communication patterns and intentions
  • Linguistics: Analyze pragmatic aspects of language
  • Social Sciences: Understanding online discourse patterns
  • Education: Teaching healthy communication skills

Limitations and Considerations

  • Trained primarily on English text
  • Performance may vary on highly context-dependent cases
  • Best suited for interpersonal communication analysis
  • Cultural and contextual nuances may affect accuracy
  • Multi-label predictions require threshold tuning for optimal results

Model Card Contact

For questions, issues, or collaboration opportunities, please open an issue on the model repository.

Ethical Considerations

This model is designed to help understand communication patterns for constructive purposes such as:

  • Improving dialogue quality
  • Identifying harmful communication patterns
  • Supporting mental health and relationship counseling
  • Educational applications

Important: This model should not be used for:

  • Surveillance without consent
  • Discriminatory decision-making
  • Automated content removal without human review
  • Any application that could harm individuals or communities

Citation

If you use this model in your research, please cite:

@misc{intentanalyzer2024,
  author = {SamanthaStorm},
  title = {IntentAnalyzer: Multi-Label Communication Intent Detection},
  year = {2024},
  publisher = {Hugging Face},
  url = {https://huggingface.co/SamanthaStorm/intentanalyzer}
}

License

This model is released under the MIT License.

Companion Models

This model works excellently in combination with:

  • FallacyFinder (SamanthaStorm/fallacyfinder) - Logical fallacy detection
  • Together they provide comprehensive communication analysis covering both logical reasoning and psychological intent

IntentAnalyzer - Understanding the psychology behind human communication 🎭