README.md

---
title: Interactive Named Entity Recognizer
emoji: 🏷️
colorFrom: purple
colorTo: indigo
sdk: gradio
python_version: "3.10"
app_file: app.py
pinned: false
license: mit
---

# Interactive Named Entity Recognizer (NER)

This is a premium, lightweight, interactive Named Entity Recognition tool designed specifically for computational social science and humanities courses.

## Features
- **Dual Inputs**: Paste raw text directly or upload datasets (`.csv`, `.xlsx`, or `.txt`).
- **Flexible Models**:
  - **spaCy (Local & Fast)**: Runs high-speed extraction using the standard English model (`en_core_web_sm`) locally on CPU.
  - **Transformers (API Mode)**: Leverages advanced deep learning models (like BERT-NER) through Hugging Face's Serverless API with your personal access token.
- **Beautiful Visual Color-Highlighting**: Leverages Gradio's native highlighted text component to render custom color backings for people, locations, and organizations.
- **Statistics & Charts**: Visualizes entity type distribution in a dark-themed Plotly chart.
- **Dual Format Exports**: Download full data reports in either **CSV** or **JSON** format.