Metadata-Version: 2.1
Name: onomancer
Version: 0.0.1
Summary: Lookup and/or predict gender of given first name.
Home-page: https://github.com/parthmaul/onomancer
Author: Parth Jalundhwala
Author-email: pjalundh@gmail.com
License: UNKNOWN
Keywords: gender,predict,names
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Python: >=3.6
Description-Content-Type: text/markdown
Requires-Dist: fasttext (==0.9.2)
Requires-Dist: setuptools (>=46.0.0)

# onomancer
*onomancer* is an open source python package for inferring gender from first names for feature engineering. Name-Gender mappings are based on lookups in `gender_lookup.json` created from combining data provided from the [Social Security Administration](https://www.ssa.gov/oact/babynames/limits.html) and [World Intellectual Property Organization](https://ideas.repec.org/s/wip/eccode.html) located in the data folder. If a Name-Gender mapping does not exist, the gender is predicted from a pre-trained model named `model.bin` also located in the data folder. 

## Requirements
onomancer requires:

- python >= 3.6.x.
- fasttext == 0.9.2 (to load pre-trained model)

## Installing
`$ pip install onomancer`

## Usage

```
$ python
>>> import onomancer as ono
>>> ono.predict(['GALADRIEL', 'GanDALF'])
{'GANDALF': 'M', 'GALADRIEL': 'F'}
```


