Create README.md

README.md

@@ -0,0 +1,39 @@
+readme = f"""---
+library_name: scikit-learn
+tags:
+- spam-detection
+- classic-ml
+- tfidf
+- random-forest
+task: text-classification
+license: mit
+---
+
+# Spam Detector – RandomForest + TF-IDF (Classical ML)
+
+**Labels:** 0 = ham, 1 = spam  
+**Training features:** TF-IDF (1k unigrams)  
+**Final model:** RandomForestClassifier
+
+## Usage
+
+```python
+import joblib
+from huggingface_hub import hf_hub_download
+
+repo_id = "<YOUR_USERNAME>/spam-detector-rf-tfidf"
+
+vec_path = hf_hub_download(repo_id, "vectorizer.pkl")
+mdl_path = hf_hub_download(repo_id, "rf_model.pkl")
+
+vectorizer = joblib.load(vec_path)
+model = joblib.load(mdl_path)
+
+texts = [
+    "Congratulations! You've won a free prize, click here!",
+    "Are we still on for lunch today?"
+]
+X = vectorizer.transform(texts)
+proba = model.predict_proba(X)[:, 1]  # probability spam
+pred = (proba >= 0.5).astype(int)
+print(list(zip(texts, pred, proba)))