Initial Commit

.dockerignore

@@ -0,0 +1,6 @@
+venv/
+__pycache__/
+*.pyc
+*.pyo
+.git/
+*.log

.gitignore

@@ -0,0 +1,4 @@
+venv/
+__pycache__/
+*.pyc
+*.pyo

CONTRIBUTING.md

@@ -0,0 +1,35 @@
+# Contributing to Speak Your Mind FastAPI
+
+Thank you for your interest in contributing!
+
+## How to Contribute
+1. **Fork** the repository.
+2. **Clone** your fork:  
+   ```bash
+   git clone https://huggingface.co/spaces/ADK09/speak-your-mind-fastapi
+   cd speak-your-mind-fastapi
+   ```
+3. **Create a new branch** for your feature or fix:
+   ```bash
+   git checkout -b feature-name
+   ```
+4. **Make changes** and commit:
+   ```bash
+   git commit -m "Add feature XYZ"
+   ```
+5. **Push to your branch** and create a **pull request**.
+
+## Guidelines
+- Follow **PEP8** coding standards.
+- Write **clear commit messages**.
+- Keep PRs **small and focused**.
+- **Do not modify the model itself**, as we are only using `cardiffnlp/twitter-roberta-base-emotion-latest`.
+
+## Running Tests
+Before submitting a pull request, run:
+```bash
+pytest test_app.py
+```
+
+Happy coding!
+```

Dockerfile

@@ -0,0 +1,20 @@
+FROM python:3.9-slim
+
+RUN useradd -m -u 1000 user
+USER user
+
+ENV HF_HOME=/app/cache
+ENV PATH="/home/user/.local/bin:$PATH"
+
+WORKDIR /app
+
+COPY --chown=user:user requirements.txt requirements.txt
+RUN pip install --no-cache-dir --upgrade -r requirements.txt
+
+RUN mkdir -p /app/cache && chown -R user:user /app/cache
+
+COPY --chown=user:user . /app
+
+EXPOSE 7860
+
+CMD ["uvicorn", "app:app", "--host", "0.0.0.0", "--port", "7860"]

LICENSE

@@ -0,0 +1,26 @@
+MIT License
+
+Copyright (c) 2025 ADK09
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+## Third-Party Acknowledgment
+This project **only uses** the pre-trained model **`cardiffnlp/twitter-roberta-base-emotion-latest`**,  
+which is publicly available under its respective license at **Hugging Face**:  
+[https://huggingface.co/cardiffnlp/twitter-roberta-base-emotion-latest](https://huggingface.co/cardiffnlp/twitter-roberta-base-emotion-latest)
+
+This project **does not fine-tune or modify the model** in any way.
+
+## Disclaimer
+The software is provided "as is", without warranty of any kind, express or implied,  
+including but not limited to the warranties of merchantability, fitness for a particular purpose,  
+and non-infringement. In no event shall the authors be liable for any claim, damages, or other liability  
+arising from the use of this software.

README.md

@@ -9,3 +9,71 @@ license: mit
 ---
 
 Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+
+# Speak Your Mind FastAPI 
+
+**Speak Your Mind** is an **emotion detection API** built with **FastAPI**.  
+It uses the **pre-trained RoBERTa model** [`cardiffnlp/twitter-roberta-base-emotion-latest`](https://huggingface.co/cardiffnlp/twitter-roberta-base-emotion-latest) to analyze emotions from text.
+
+## Features
+- **FastAPI-based REST API** running on **port 7860**.
+- Uses **pre-trained RoBERTa model** for emotion classification.
+- **Dockerized for easy deployment**.
+
+## Model Information
+This API uses the **`cardiffnlp/twitter-roberta-base-emotion-latest`** model without any additional training or fine-tuning.  
+It predicts emotions such as **joy, sadness, optimism, and more**.
+
+- **Model Source:** [Hugging Face Model Page](https://huggingface.co/cardiffnlp/twitter-roberta-base-emotion-latest)
+- **No additional fine-tuning or training has been done**.
+- **Supported Emotions:** Joy, Sadness, Optimism, etc.
+
+## 🛠️ Installation & Usage
+
+### ▶ Run Locally  
+```bash
+git clone https://huggingface.co/spaces/ADK09/speak-your-mind-fastapi
+cd speak-your-mind-fastapi
+pip install -r requirements.txt
+uvicorn app:app --host 0.0.0.0 --port 7860
+```
+Access the API at `http://localhost:7860/docs`
+
+### ▶ Run with Docker  
+```bash
+docker build -t speak-your-mind .
+docker run -p 7860:7860 speak-your-mind
+```
+
+## API Endpoints
+| Method | Endpoint | Description |
+|--------|----------|-------------|
+| `GET` | `/` | Check if API is running |
+| `POST` | `/classify-emotion` | Predict emotion from text |
+
+### Example Request
+```json
+{
+  "text": "I feel fantastic today!"
+}
+```
+### Example Response
+```json
+{
+  "predicted_emotion": "joy"
+}
+```
+
+## Disclaimer
+This API **only uses the pre-trained model** and does not modify or fine-tune it.  
+Predictions are based on the **original model's training data**
+
+## License
+This project is licensed under the **MIT License**.
+
+## Acknowledgments
+This project **uses the RoBERTa model fine-tuned by Cardiff NLP**.  
+Special thanks to the **Hugging Face** and **Cardiff NLP teams**.
+
+- [`cardiffnlp/twitter-roberta-base-emotion-latest`](https://huggingface.co/cardiffnlp/twitter-roberta-base-emotion-latest)
+```

app.py

@@ -0,0 +1,37 @@
+from fastapi import FastAPI, HTTPException
+from pydantic import BaseModel
+from transformers import AutoTokenizer, AutoModelForSequenceClassification
+import torch
+
+app = FastAPI()
+
+tokenizer = AutoTokenizer.from_pretrained("cardiffnlp/twitter-roberta-base-emotion-latest")
+model = AutoModelForSequenceClassification.from_pretrained("cardiffnlp/twitter-roberta-base-emotion-latest")
+
+class TextRequest(BaseModel):
+    text: str
+
+@app.get("/")
+def home():
+    return {"message": "Speak your mind emotion API is running"}
+
+@app.post("/classify-emotion")
+async def classify_emotion(request: TextRequest):
+    try:
+        text = request.text  
+
+        inputs = tokenizer(text, return_tensors="pt", truncation=True, padding=True, max_length=512)
+
+        with torch.no_grad():
+            outputs = model(**inputs)
+
+
+        logits = outputs.logits
+        predicted_class_id = torch.argmax(logits, dim=-1).item()
+        predicted_emotion = model.config.id2label[predicted_class_id]  
+
+        return {"predicted_emotion": predicted_emotion}
+
+    except Exception as e:
+        raise HTTPException(status_code=500, detail=str(e))  
+

requirements.txt

@@ -0,0 +1,6 @@
+fastapi
+uvicorn
+transformers
+torch
+httpx
+pytest

test_app.py

@@ -0,0 +1,24 @@
+from fastapi.testclient import TestClient
+from app import app
+
+client = TestClient(app)
+
+def test_home():
+    response = client.get("/")
+    assert response.status_code == 200
+    assert response.json() == {"message": "Speak your mind emotion API is running"}
+
+def test_predict():
+    test_input = {"text": "I feel fantastic today!"}
+    
+    response = client.post("/classify-emotion", json=test_input)
+    
+    assert response.status_code == 200 
+    assert "predicted_emotion" in response.json()  
+    assert isinstance(response.json()["predicted_emotion"], str)  
+
+if __name__ == "__main__":
+    test_home()
+    test_predict()
+    print("All tests passed successfully!")
+