Upload folder using huggingface_hub

.gitignore

@@ -0,0 +1,7 @@
+.venv/
+__pycache__/
+*.py[cod]
+.env
+.DS_Store
+.idea/
+.vscode/

README.md

@@ -1,14 +1,37 @@
 ---
 title: Beginner Sentiment Analyzer
-emoji: 🏆
-colorFrom: pink
-colorTo: green
+emoji: 🤗
+colorFrom: blue
+colorTo: purple
 sdk: gradio
-sdk_version: 6.20.0
-python_version: '3.12'
+sdk_version: 5.0.0
 app_file: app.py
 pinned: false
-short_description: This is beggineers project to learn about hugging afce
 ---
 
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# Beginner Sentiment Analyzer
+
+A beginner-friendly sentiment analysis project built using Hugging Face
+Transformers, DistilBERT, PyTorch, and Gradio.
+
+## Features
+
+- Classifies English text as positive or negative
+- Shows confidence scores
+- Includes example sentences
+- Handles empty and excessively long input
+- Runs locally or on Hugging Face Spaces
+
+## Model
+
+This project uses:
+
+`distilbert/distilbert-base-uncased-finetuned-sst-2-english`
+
+## Run locally
+
+```bash
+python -m venv .venv
+source .venv/bin/activate
+pip install -r requirements.txt
+python app.py

app.py

@@ -0,0 +1,71 @@
+from typing import Any
+
+import gradio as gr
+from transformers import Pipeline, pipeline
+
+
+MODEL_NAME = "distilbert/distilbert-base-uncased-finetuned-sst-2-english"
+
+classifier: Pipeline = pipeline(
+    task="sentiment-analysis",
+    model=MODEL_NAME,
+)
+
+
+def analyze_sentiment(text: str) -> dict[str, float]:
+    """Analyze text and return probabilities for Gradio's Label component."""
+
+    cleaned_text = text.strip()
+
+    if not cleaned_text:
+        raise gr.Error("Please enter a sentence before analyzing.")
+
+    if len(cleaned_text) > 1000:
+        raise gr.Error("Please keep the text below 1,000 characters.")
+
+    predictions: list[dict[str, Any]] = classifier(
+        cleaned_text,
+        top_k=None,
+    )
+
+    return {
+        prediction["label"].title(): float(prediction["score"])
+        for prediction in predictions
+    }
+
+
+examples = [
+    ["I loved working on this machine-learning project."],
+    ["The application was confusing and frustrating."],
+    ["The workshop was useful, but it was quite long."],
+]
+
+demo = gr.Interface(
+    fn=analyze_sentiment,
+    inputs=gr.Textbox(
+        lines=5,
+        max_lines=10,
+        label="Your text",
+        placeholder="Example: Learning Hugging Face is exciting!",
+    ),
+    outputs=gr.Label(
+        label="Sentiment prediction",
+        num_top_classes=2,
+    ),
+    examples=examples,
+    title="🤗 Beginner Sentiment Analyzer",
+    description=(
+        "Enter an English sentence and let a pretrained Hugging Face "
+        "model classify its sentiment."
+    ),
+    article=(
+        "This beginner project uses DistilBERT, Transformers, "
+        "PyTorch, and Gradio."
+    ),
+    submit_btn="Analyze sentiment",
+    clear_btn="Clear",
+)
+
+
+if __name__ == "__main__":
+    demo.launch()

requirements.txt

@@ -0,0 +1,77 @@
+annotated-doc==0.0.5
+annotated-types==0.8.0
+anyio==4.14.2
+audioop-lts==0.2.2
+brotli==1.2.0
+certifi==2026.7.22
+click==8.4.2
+cuda-bindings==13.3.1
+cuda-pathfinder==1.6.0
+cuda-toolkit==13.0.3.0
+fastapi==0.140.13
+filelock==3.32.0
+fsspec==2026.7.0
+gradio==6.20.0
+gradio_client==2.5.0
+groovy==0.1.2
+h11==0.16.0
+hf-gradio==0.4.1
+hf-xet==1.5.2
+httpcore==1.0.9
+httpx==0.28.1
+huggingface_hub==1.25.1
+idna==3.18
+Jinja2==3.1.6
+markdown-it-py==4.2.0
+MarkupSafe==3.0.3
+mdurl==0.1.2
+mpmath==1.3.0
+networkx==3.6.1
+numpy==2.5.1
+nvidia-cublas==13.1.1.3
+nvidia-cuda-cupti==13.0.85
+nvidia-cuda-nvrtc==13.0.88
+nvidia-cuda-runtime==13.0.96
+nvidia-cudnn-cu13==9.20.0.48
+nvidia-cufft==12.0.0.61
+nvidia-cufile==1.15.1.6
+nvidia-curand==10.4.0.35
+nvidia-cusolver==12.0.4.66
+nvidia-cusparse==12.6.3.3
+nvidia-cusparselt-cu13==0.8.1
+nvidia-nccl-cu13==2.29.7
+nvidia-nvjitlink==13.3.33
+nvidia-nvshmem-cu13==3.4.5
+nvidia-nvtx==13.0.85
+orjson==3.11.9
+packaging==26.2
+pandas==3.0.5
+pillow==12.3.0
+pydantic==2.13.4
+pydantic_core==2.46.4
+pydub==0.25.1
+Pygments==2.20.0
+python-dateutil==2.9.0.post0
+python-multipart==0.0.32
+pytz==2026.3.post1
+PyYAML==6.0.3
+regex==2026.7.19
+rich==15.0.0
+safehttpx==0.1.7
+safetensors==0.8.0
+semantic-version==2.10.0
+setuptools==83.0.0
+shellingham==1.5.4
+six==1.17.0
+starlette==1.3.1
+sympy==1.14.0
+tokenizers==0.22.2
+tomlkit==0.14.0
+torch==2.13.0
+tqdm==4.70.0
+transformers==5.14.1
+triton==3.7.1
+typer==0.27.0
+typing-inspection==0.4.2
+typing_extensions==4.16.0
+uvicorn==0.51.0