README.md

---
title: Clustering Analyzer
emoji: 🧩
colorFrom: blue
colorTo: indigo
sdk: gradio
app_file: app.py
pinned: false
---

# Document & Artifact Clustering Analyzer

An interactive computational tool designed for digital humanities and social science students to automatically group similar documents, articles, or transcripts using unsupervised machine learning.

### Features
1. **Multi-Model Clustering**: Choose between K-Means and Agglomerative Hierarchical clustering.
2. **Dynamic 2D Projections**: Project high-dimensional text vectors into a 2D scatter plot using PCA (SVD) or t-SNE.
3. **Representative Keywords Extraction**: Identify the top TF-IDF words characterizing each cluster subgroup.
4. **Data Exports**: Download the full dataset labeled with assigned cluster IDs.