README.md

---
title: Disilbert
emoji: 🏆
colorFrom: purple
colorTo: purple
sdk: gradio
sdk_version: 5.31.0
app_file: app.py
pinned: false
license: apache-2.0
short_description: smaller bert
---

# DistilBERT Sentiment Analysis App with Live Logs & Visualization

[![Hugging Face](https://img.shields.io/badge/Hugging%20Face-Transformers-blue?logo=huggingface)](https://huggingface.co/)
[![Gradio](https://img.shields.io/badge/Gradio-Interactive-green?logo=gradio)](https://gradio.app/)
[![Python](https://img.shields.io/badge/Python-3.7%2B-yellow?logo=python)](https://www.python.org/)
[![License](https://img.shields.io/github/license/yourusername/distilbert-sentiment-app)](LICENSE)

---

## 🚀 Overview

Welcome to the **DistilBERT Sentiment Analysis App** — a sleek, lightweight, and CPU-friendly application designed to provide **real-time sentiment analysis** powered by Hugging Face's **DistilBERT** model fine-tuned on SST-2. 

This app is ideal for anyone looking to quickly analyze text sentiment, especially in domains like salon product reviews, customer feedback, or social media posts. Its intuitive interface features:

- Instant sentiment classification with confidence scores
- Live session logging of all analyses performed
- Dynamic, easy-to-understand sentiment distribution visualization
- Clean, responsive UI built with [Gradio](https://gradio.app)

---

## 📚 Why This App?

Sentiment analysis helps businesses gauge customer emotions and feedback trends efficiently. Using this app, you can:

- Identify positive vs. negative feedback instantly
- Monitor evolving sentiment trends during live sessions
- Gain insights visually with a real-time bar chart
- Deploy and run easily on free Hugging Face Spaces or on any CPU machine

---

## ⚙️ Features

| Feature                        | Description                                  |
|-------------------------------|----------------------------------------------|
| **DistilBERT backend**         | Uses a lightweight, fast transformer model  |
| **Real-time sentiment analysis** | Processes input text and returns label + confidence |
| **Session logging**            | Maintains an interactive log of all analyses |
| **Visual sentiment distribution** | Updates a bar chart showing counts of positive and negative labels |
| **User-friendly Gradio UI**    | Simple interface optimized for clarity and usability |
| **CPU optimized**              | Perfect for free Hugging Face Spaces or low-resource machines |

---

## 🛠️ Installation & Setup

### Prerequisites

- Python 3.7 or higher
- Git (optional, for cloning repo)

### Installation Steps

1. **Clone the repository** (or download the source)

```bash
git clone https://github.com/yourusername/distilbert-sentiment-app.git
cd distilbert-sentiment-app