Sentiment_analysis / README.md
Mourya0402's picture
Upload 4 files
d85158b verified
|
Raw History Blame Contribute Delete
1.54 kB

Text Sentiment Analyzer (Local)

A simple local Gradio app that classifies text sentiment using a Hugging Face Transformers pipeline (distilbert-base-uncased-finetuned-sst-2-english). No remote APIs.

Quickstart

python -m venv .venv && source .venv/bin/activate   # Windows: .venv\Scripts\activate
pip install -r requirements.txt
python app.py

Open the printed local URL and paste any text. Use the Neutral margin slider to make the classifier return NEUTRAL when POS vs NEG is too close to call.

Why this fits Deliverable 2

  • Runs locally on your hardware (no InferenceClient, no external API).
  • Clear contrast vs. your API-based product from Deliverable 1.
  • Includes tests and a GitHub Action that runs pytest on push/PR.

Project layout

sentiment_local/
β”œβ”€ app.py
β”œβ”€ sentiment.py
β”œβ”€ requirements.txt
β”œβ”€ README.md
β”œβ”€ tests/
β”‚  └─ test_sentiment.py
└─ .github/workflows/
   └─ ci.yml

Notes

  • On the first run, Transformers will download the model weights to your machine (cached under ~/.cache/huggingface/). Subsequent runs are fully local.
  • If you need strictly offline installs, pre-download the model:
    python -c "from transformers import AutoTokenizer, AutoModelForSequenceClassification; \
               AutoTokenizer.from_pretrained('distilbert-base-uncased-finetuned-sst-2-english'); \
               AutoModelForSequenceClassification.from_pretrained('distilbert-base-uncased-finetuned-sst-2-english')"