Apppublic

ashish-soni08/Named-Entity-Recognition

sourceHugging Faceapache-2.0updated 1y agoView on Hugging Face

2likes

App README

Named Entity Recognition (NER) App 🏷️

A web-based Named Entity Recognition tool that automatically identifies and highlights entities like names, locations, organizations, and more from text using state-of-the-art NLP models. Built with Gradio and deployed on Hugging Face Spaces.

[image]

🚀 Live Demo

Try the app: Named-Entity-Recognition

✨ Features

—Automatic Entity Detection: Instantly identify persons, locations, organizations, and miscellaneous entities
—Visual Highlighting: Entities are color-coded and highlighted for easy identification
—Real-time Processing: Get results in seconds with pre-trained BERT model
—Clean Interface: Intuitive web UI built with Gradio
—Mobile Responsive: Works seamlessly on desktop and mobile devices

🛠️ Technology Stack

—Backend: Python, Hugging Face Transformers
—Frontend: Gradio
—Model: dslim/bert-base-NER
—Deployment: Hugging Face Spaces

🏃‍♂️ Quick Start

Prerequisites

bash

Python 3.8+
pip

Installation

1.Clone the repository:

bash

git clone https://github.com/Ashish-Soni08/named-entity-recognition-app.git
cd ner-app

1.Install dependencies:

bash

pip install -r requirements.txt

1.Run the application:

bash

python app.py

1.Open your browser and navigate to http://localhost:7860

📋 Usage

1.Input Text: Enter or paste the text you want to analyze in the "Text to find entities" box
2.Process: Click the "Submit" button to perform Named Entity Recognition
3.View Results: Identified entities will be highlighted with different colors based on their type

Entity Types Detected

—PER (Person): Names of people
—LOC (Location): Geographic locations, cities, countries
—ORG (Organization): Companies, institutions, organizations
—MISC (Miscellaneous): Other named entities

Example

Input:

Apple Inc. is headquartered in Cupertino, California. Tim Cook is the current CEO of the company.

Output:

[Apple Inc.](ORG) is headquartered in [Cupertino](LOC), [California](LOC). [Tim Cook](PER) is the current CEO of the company.

🧠 Model Information

This app uses dslim/bert-base-NER, a fine-tuned BERT model for Named Entity Recognition:

—Architecture: BERT-base
—Parameters: ~110 million parameters
—Entity Types: Person (PER), Location (LOC), Organization (ORG), Miscellaneous (MISC)
—Performance: F1-score of ~91%

📁 Project Structure

ner-app/
├── app.py                 # Main Gradio application
├── requirements.txt       # Python dependencies
├── README.md             # Project documentation

📄 License

This project is licensed under the Apache License 2.0

🙏 Acknowledgments

—Hugging Face for the Transformers library and model hosting
—Gradio for the web interface framework
—dslim for the fine-tuned BERT-NER model

📞 Contact

Ashish Soni - ashish.soni2091@gmail.com

Project Link: Github