Initial commit: Add sentiment analysis application files

PROGRESS.md

@@ -0,0 +1,54 @@
+# Project Progress Log
+
+This document tracks the step-by-step process of creating and deploying the Simple Sentiment Analyzer application.
+
+## 1. Prerequisites & Initial Setup
+
+- **Goal:** Build and deploy a sentiment analysis web application using Hugging Face.
+- **Accounts:** A new Hugging Face account was created and verified via email. A GitHub account was already available.
+- **Tools:** Confirmed that `python` and `git` were installed locally on the Ubuntu system.
+
+## 2. Local Project Initialization
+
+- **Directory:** Created a project directory named `sentiment-app`.
+- **Dependency Management:** Chose to use `Poetry` for modern Python package and environment management.
+- **Poetry Setup:**
+    - Initialized the project with `poetry init`, creating the `pyproject.toml` configuration file.
+    - Added the required libraries (`transformers`, `torch`, and `gradio`) using the `poetry add` command. This automatically created a virtual environment and installed the dependencies.
+
+## 3. Application Development
+
+- **Main Application (`app.py`):**
+    - Created the `app.py` file.
+    - Wrote the Python code to load a pre-trained sentiment analysis model using the `transformers` pipeline.
+    - Wrote a function `analyze_sentiment` to process user input and return the model's prediction.
+    - Built a web user interface using `Gradio`, creating a title, description, and a simple textbox input/output.
+
+- **Deployment Dependencies (`requirements.txt`):**
+    - To ensure compatibility with Hugging Face Spaces, a `requirements.txt` file was generated from the Poetry environment using the `poetry export` command.
+
+## 4. Local Testing
+
+- **Execution:** The application was run locally from the terminal using `poetry run python app.py`.
+- **Verification:** The Gradio server started successfully. The application was accessed via a local URL (`http://127.0.0.1:7860`) in a web browser.
+- **Functionality Check:** Tested the app with both positive and negative sentences to confirm it was working as expected.
+- **Shutdown:** The local server was stopped gracefully using `Ctrl+C` in the terminal.
+
+## 5. Deployment to Hugging Face Spaces
+
+- **Git Initialization:** The project was already a Git repository. New files (`app.py`, `pyproject.toml`, `poetry.lock`, `requirements.txt`) were staged with `git add` and committed with `git commit`.
+
+- **Space Creation:**
+    - A new "Space" was created on the Hugging Face website.
+    - The Space was configured with the `Gradio` SDK.
+
+- **Connecting Local to Remote:**
+    - The new Hugging Face Space's Git URL was added as a remote to the local repository under the name `huggingface` (`git remote add ...`).
+
+- **First Push & Reconciliation:**
+    - The initial `git push huggingface main` failed due to the remote Space having its own initial commit (with a `README.md` file), causing "divergent histories".
+    - This was resolved by pulling the remote changes first using `git pull huggingface main --allow-unrelated-histories`. This merged the remote's `README.md` into the local project.
+
+- **Documentation:**
+    - The default `README.md` was updated with a detailed description of the project, its technologies, and usage instructions.
+    - This `PROGRESS.md` file was created to document the project's entire lifecycle.

README.md

@@ -0,0 +1,13 @@
+---
+title: Simple Sentiment Analyzer
+emoji: 🔥
+colorFrom: green
+colorTo: gray
+sdk: gradio
+sdk_version: 5.38.0
+app_file: app.py
+pinned: false
+short_description: A simple web app to analyze text sentiment (Positive/Negativ
+---
+
+Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference

app.py

@@ -0,0 +1,49 @@
+# Import the necessary libraries
+import gradio as gr
+from transformers import pipeline
+
+# Load the sentiment analysis pipeline
+# This will download the model and tokenizer for the first time.
+# The model is 'distilbert-base-uncased-finetuned-sst-2-english'.
+# It's a lightweight and fast model fine-tuned for sentiment analysis.
+print("Loading sentiment analysis pipeline...")
+sentiment_pipeline = pipeline("sentiment-analysis")
+print("Pipeline loaded successfully.")
+
+# Define the function that will perform the sentiment analysis
+def analyze_sentiment(text):
+    """
+    Analyzes the sentiment of a given text.
+    
+    Args:
+        text (str): The input text from the user.
+        
+    Returns:
+        str: A formatted string with the prediction and score.
+    """
+    if text:
+        # The pipeline returns a list of dictionaries.
+        # e.g., [{'label': 'POSITIVE', 'score': 0.999}]
+        result = sentiment_pipeline(text)[0]
+        label = result['label']
+        score = result['score']
+        
+        # Format the output for better readability
+        return f"Sentiment: {label} (Score: {score:.4f})"
+    else:
+        return "Please enter some text to analyze."
+
+# Create the Gradio interface for the application
+iface = gr.Interface(
+    fn=analyze_sentiment,
+    inputs=gr.Textbox(lines=5, placeholder="Enter text here..."),
+    outputs="text",
+    title="Simple Sentiment Analyzer",
+    description="Enter any English text to find out if its sentiment is POSITIVE or NEGATIVE. Powered by Hugging Face Transformers.",
+    allow_flagging="never" # Disables the flagging feature
+)
+
+# Launch the web application
+if __name__ == "__main__":
+    print("Launching Gradio interface...")
+    iface.launch()

pyproject.toml

@@ -0,0 +1,17 @@
+[tool.poetry]
+name = "sentiment-app"
+version = "0.1.0"
+description = ""
+authors = ["Teymoor <teymoor.k@gmail.com>"]
+readme = "README.md"
+
+[tool.poetry.dependencies]
+python = "^3.12"
+transformers = "^4.53.2"
+torch = "^2.7.1"
+gradio = "^5.38.0"
+
+
+[build-system]
+requires = ["poetry-core"]
+build-backend = "poetry.core.masonry.api"

requirements.txt

@@ -0,0 +1,81 @@
+aiofiles==24.1.0 ; python_version >= "3.12" and python_version < "4.0"
+annotated-types==0.7.0 ; python_version >= "3.12" and python_version < "4.0"
+anyio==4.9.0 ; python_version >= "3.12" and python_version < "4.0"
+audioop-lts==0.2.1 ; python_version >= "3.13" and python_version < "4.0"
+brotli==1.1.0 ; python_version >= "3.12" and python_version < "4.0"
+certifi==2025.7.14 ; python_version >= "3.12" and python_version < "4.0"
+charset-normalizer==3.4.2 ; python_version >= "3.12" and python_version < "4.0"
+click==8.2.1 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+colorama==0.4.6 ; python_version >= "3.12" and python_version < "4.0" and platform_system == "Windows"
+fastapi==0.116.1 ; python_version >= "3.12" and python_version < "4.0"
+ffmpy==0.6.0 ; python_version >= "3.12" and python_version < "4.0"
+filelock==3.18.0 ; python_version >= "3.12" and python_version < "4.0"
+fsspec==2025.7.0 ; python_version >= "3.12" and python_version < "4.0"
+gradio-client==1.11.0 ; python_version >= "3.12" and python_version < "4.0"
+gradio==5.38.0 ; python_version >= "3.12" and python_version < "4.0"
+groovy==0.1.2 ; python_version >= "3.12" and python_version < "4.0"
+h11==0.16.0 ; python_version >= "3.12" and python_version < "4.0"
+hf-xet==1.1.5 ; python_version >= "3.12" and python_version < "4.0" and (platform_machine == "x86_64" or platform_machine == "amd64" or platform_machine == "arm64" or platform_machine == "aarch64")
+httpcore==1.0.9 ; python_version >= "3.12" and python_version < "4.0"
+httpx==0.28.1 ; python_version >= "3.12" and python_version < "4.0"
+huggingface-hub==0.33.4 ; python_version >= "3.12" and python_version < "4.0"
+idna==3.10 ; python_version >= "3.12" and python_version < "4.0"
+jinja2==3.1.6 ; python_version >= "3.12" and python_version < "4.0"
+markdown-it-py==3.0.0 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+markupsafe==3.0.2 ; python_version >= "3.12" and python_version < "4.0"
+mdurl==0.1.2 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+mpmath==1.3.0 ; python_version >= "3.12" and python_version < "4.0"
+networkx==3.5 ; python_version >= "3.12" and python_version < "4.0"
+numpy==2.3.1 ; python_version >= "3.12" and python_version < "4.0"
+nvidia-cublas-cu12==12.6.4.1 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cuda-cupti-cu12==12.6.80 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cuda-nvrtc-cu12==12.6.77 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cuda-runtime-cu12==12.6.77 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cudnn-cu12==9.5.1.17 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cufft-cu12==11.3.0.4 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cufile-cu12==1.11.1.6 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-curand-cu12==10.3.7.77 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cusolver-cu12==11.7.1.2 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cusparse-cu12==12.5.4.2 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-cusparselt-cu12==0.6.3 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-nccl-cu12==2.26.2 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-nvjitlink-cu12==12.6.85 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+nvidia-nvtx-cu12==12.6.77 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+orjson==3.11.0 ; python_version >= "3.12" and python_version < "4.0"
+packaging==25.0 ; python_version >= "3.12" and python_version < "4.0"
+pandas==2.3.1 ; python_version >= "3.12" and python_version < "4.0"
+pillow==11.3.0 ; python_version >= "3.12" and python_version < "4.0"
+pydantic-core==2.33.2 ; python_version >= "3.12" and python_version < "4.0"
+pydantic==2.11.7 ; python_version >= "3.12" and python_version < "4.0"
+pydub==0.25.1 ; python_version >= "3.12" and python_version < "4.0"
+pygments==2.19.2 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+python-dateutil==2.9.0.post0 ; python_version >= "3.12" and python_version < "4.0"
+python-multipart==0.0.20 ; python_version >= "3.12" and python_version < "4.0"
+pytz==2025.2 ; python_version >= "3.12" and python_version < "4.0"
+pyyaml==6.0.2 ; python_version >= "3.12" and python_version < "4.0"
+regex==2024.11.6 ; python_version >= "3.12" and python_version < "4.0"
+requests==2.32.4 ; python_version >= "3.12" and python_version < "4.0"
+rich==14.0.0 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+ruff==0.12.4 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+safehttpx==0.1.6 ; python_version >= "3.12" and python_version < "4.0"
+safetensors==0.5.3 ; python_version >= "3.12" and python_version < "4.0"
+semantic-version==2.10.0 ; python_version >= "3.12" and python_version < "4.0"
+setuptools==80.9.0 ; python_version >= "3.12" and python_version < "4.0"
+shellingham==1.5.4 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+six==1.17.0 ; python_version >= "3.12" and python_version < "4.0"
+sniffio==1.3.1 ; python_version >= "3.12" and python_version < "4.0"
+starlette==0.47.2 ; python_version >= "3.12" and python_version < "4.0"
+sympy==1.14.0 ; python_version >= "3.12" and python_version < "4.0"
+tokenizers==0.21.2 ; python_version >= "3.12" and python_version < "4.0"
+tomlkit==0.13.3 ; python_version >= "3.12" and python_version < "4.0"
+torch==2.7.1 ; python_version >= "3.12" and python_version < "4.0"
+tqdm==4.67.1 ; python_version >= "3.12" and python_version < "4.0"
+transformers==4.53.2 ; python_version >= "3.12" and python_version < "4.0"
+triton==3.3.1 ; platform_system == "Linux" and platform_machine == "x86_64" and python_version >= "3.12" and python_version < "4.0"
+typer==0.16.0 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+typing-extensions==4.14.1 ; python_version >= "3.12" and python_version < "4.0"
+typing-inspection==0.4.1 ; python_version >= "3.12" and python_version < "4.0"
+tzdata==2025.2 ; python_version >= "3.12" and python_version < "4.0"
+urllib3==2.5.0 ; python_version >= "3.12" and python_version < "4.0"
+uvicorn==0.35.0 ; python_version >= "3.12" and python_version < "4.0" and sys_platform != "emscripten"
+websockets==15.0.1 ; python_version >= "3.12" and python_version < "4.0"