Update README.md

README.md

@@ -1,20 +1,51 @@
 ---
-title: Council Topics Classifier-PT
-emoji: 🚀
-colorFrom: red
-colorTo: red
-sdk: docker
-app_port: 8501
-tags:
-- streamlit
+title: Council Topics Classifier
+emoji: 🏛️
+colorFrom: blue
+colorTo: green
+sdk: streamlit
+sdk_version: 1.36.0
+app_file: src/streamlit_app.py
 pinned: false
-short_description: Municipal Meeting Minutes Discussion Subjects Classification
-license: cc-by-nc-nd-4.0
+license: cc-by-4.0
 ---
 
-# Welcome to Streamlit!
+# 🏛️ Council Topics Classifier
 
-Edit `/src/streamlit_app.py` to customize this app to your heart's desire. :heart:
+**Council Topics Classifier** is a system for automatically identifying topics in **Portuguese municipal meeting minutes discussion subjects**.
 
-If you have any questions, checkout our [documentation](https://docs.streamlit.io) and [community
-forums](https://discuss.streamlit.io).
+---
+
+## 🎯 About
+
+This demo showcases the classifier's ability to:
+- Detect topics in Portuguese municipal texts discussion subjects
+- Use a hybrid feature set (TF-IDF + BERTimbau embeddings)
+- Combine Logistic Regression and Gradient Boosting models in an adaptive weighted ensemble
+- Apply dynamic thresholds optimized per topic
+- Handle unbalanced topic distributions with active learning
+
+---
+
+## 📊 Model Performance
+
+- **Model Architecture**: Logistic Regression + 3x Gradient Boosting models
+- **Features**: TF-IDF (1–3 n-grams) + BERTimbau contextual embeddings
+- **Adaptive weighting**: Rare topics get higher LogReg weight, common topics get higher GB weight
+- **Dynamic thresholds**: Optimized per topic using validation data
+
+---
+
+## 📝 Usage
+
+1. **Try Your Own Text**: Paste Portuguese municipal text in the input area  
+2. **Demo Examples**: Select from pre-loaded examples to see topic predictions  
+3. **View Results**: Confidence scores for each predicted topic are displayed interactively  
+
+---
+
+## 🔧 Running Locally
+
+```bash
+pip install -r requirements.txt
+streamlit run app.py