Metadata-Version: 2.1
Name: guess-indian-gender
Version: 0.1.0
Summary: Guess gender from indian names
Home-page: https://github.com/v-adhithyan/gender-guess-indiannames
Author: v-adhithyan
Author-email: pollachi.developer@gmail.com
License: MIT
Platform: UNKNOWN
Classifier: Programming Language :: Python :: 3.7
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Requires-Dist: nltk
Requires-Dist: pandas

Guess gender from indian names
==============================

Motivation
----------

I was not able to find a open source library that guess gender from
indian names. So made one.

Prerequisites
-------------

-  Python 3.7
-  Pipenv

Usage
-----

-  Clone this repository.
-  cd to the repo
-  Activate pipenv ``pipenv shell``
-  Install dependencies ``pipenv install``
-  Fire up a python shell and type the following.

.. code:: python

   >>> from guess_gender import guess_gender
   >>> guess_gender('adhithyan') # returns male
   >>> guess_gender('abi') # returns female

Accuracy
--------

-  Currently the accuracy is 0.88. Any contributions are welcome to
   improve the accuracy.

Changelog
---------

-  When the last letter is considered as a feature for gender detection
   the accuracy is 78%.
-  When the last four letters was considered the accuracy became 88%.

Todo
----

-  [ ] Convert to Pip package.
-  [ ] Convert to nice oops.

Dataset credits
---------------

-  https://github.com/mbejda
-  Male names - https://gist.github.com/mbejda/7f86ca901fe41bc14a63
-  Female names - https://gist.github.com/mbejda/9b93c7545c9dd93060bd

License
-------

MIT. See license file for more info

