Update README.md

README.md

@@ -1,15 +1,72 @@
----
-title: Ul Interference Analyzer
-emoji: 📊
-colorFrom: indigo
-colorTo: pink
-sdk: gradio
-sdk_version: 6.15.1
-python_version: '3.13'
-app_file: app.py
-pinned: false
-license: apache-2.0
-short_description: 'AI-assisted uplink interference analysis for LTE and 5G RAN '
----
-
-Check out the configuration reference at https://huggingface.co/docs/hub/spaces-config-reference
+# UL Interference Analyzer
+
+AI-assisted LTE and 5G uplink interference analysis using RF KPI and PM counter indicators.
+
+## Overview
+
+UL Interference Analyzer evaluates uplink radio conditions using commonly monitored LTE and 5G RAN KPIs including:
+
+- UL SINR
+- RTWP
+- PUSCH BLER
+- UL/DL PRB utilization
+- CQI
+
+The application applies engineering threshold logic to classify potential uplink interference conditions, congestion scenarios, and RF degradation patterns.
+
+## Features
+
+- RF KPI threshold analysis
+- Uplink interference detection
+- Capacity congestion differentiation
+- Severity grading
+- Engineering action recommendations
+- Structured operational output
+
+## Example KPIs
+
+```text
+UL SINR = -8
+PUSCH BLER = 41
+RTWP = -94
+UL PRB = 72
+DL PRB = 35
+CQI = 3
+```
+
+## Example Output
+
+- LIKELY UL INTERFERENCE
+- HIGH Severity
+- Recommended RF engineering actions
+
+## Potential Use Cases
+
+- LTE RAN troubleshooting
+- 5G uplink diagnostics
+- RF optimization workflows
+- PM counter analysis
+- Network operations support
+- Private wireless operational analysis
+
+## Current Scope
+
+This project currently uses rule-based engineering logic and static KPI interpretation.
+
+Future enhancements may include:
+
+- Historical KPI trend analysis
+- Vendor-specific logic
+- Multi-sector correlation
+- AI-assisted recommendation engines
+- RAG integration for operational runbooks
+
+## Technology Stack
+
+- Python
+- Gradio
+- Hugging Face Spaces
+
+## Disclaimer
+
+This project is intended for demonstration and operational workflow prototyping purposes only.