sentiment-scope / README.md
melkholy's picture
Ship AI text detection: enable 5 models, bake detectors, docs
8392b7d verified
|
Raw
History Blame Contribute Delete
1.94 kB
metadata
title: SentimentScope
emoji: 🎯
colorFrom: indigo
colorTo: green
sdk: docker
app_port: 7860
pinned: false
short_description: Educational sentiment analysis + AI-text detection
models:
  - cardiffnlp/twitter-roberta-base-sentiment-latest
  - distilbert/distilbert-base-uncased-finetuned-sst-2-english
  - desklib/ai-text-detector-v1.01
  - fakespot-ai/roberta-base-ai-text-detection-v1
  - Oxidane/tmr-ai-text-detector

SentimentScope

An educational sentiment-analysis showcase: paste text (or upload a CSV) and see what a transformer classifier actually does β€” class probabilities, token attributions, and side-by-side model comparison.

  • Analyze β€” 3-class sentiment (negative / neutral / positive) from RoBERTa fine-tuned on ~124M tweets, with per-class confidence bars.
  • Explain β€” token-level attributions via Layer Integrated Gradients: which words pushed the model toward its prediction.
  • Batch β€” CSV upload with aggregate charts.
  • Compare β€” the same text through different models (3-class social-media RoBERTa vs binary SST-2 DistilBERT) to see domain and label-space mismatch.
  • AI Detector β€” one paragraph run through three AI-text detectors at once (desklib / fakespot / oxidane), with a disagreement flag and a verbatim uncertainty warning: detector disagreement is the uncertainty signal.
  • How it works β€” a plain-language walkthrough of the pipeline.

Public deployment limits

This free CPU Space is rate-limited (30 requests/min per IP) and serves an allowlist of five models β€” two sentiment models plus all three AI detectors. Clone the repo and run it locally (docker compose or the dev servers) for the full model registry.

Backend: FastAPI + PyTorch + transformers + captum. Frontend: React + Vite. The container serves both β€” the SPA via FastAPI StaticFiles, the API under /api/*, weights baked into the image so cold starts never re-download.