names.io/README.md

4.7 KiB

name-dataset

A Global Exhaustive First and Last Name Database

Features

  • ~160k first names
  • ~100k last names
  • Find Names in Texts
  • High Precision / Recall
  • Worldwide Names

Installation

npm install name-dataset

Usage

const Names = require('name-dataset')
echo -e "$(python main.py 'Brian is in the kitchen while Amanda is watching the TV on the sofa.\nThey are both waiting for Alfred to come.')"

How reliable is it?

Well, it depends if you are looking for a high recall or a high precision. For example, the word Rose can be either a name or a noun. If we include it in the list, then we increase the precision but we decrease the recall. And vice versa, if it's not in the list. The library checks that the word starts with a capital letter. In our case, we emphasize more on precision. So I would say the best use case here is to check whether it's a name or not based on a prior knowledge that the customer has submitted a name.

Here is an example on a (old) text: ALI BABA AND THE FORTY THIEVES.

Dataset Generation

generate.sh