# Indian Name Maker
A Python package to generate Indian names. The package uses a synthetically generated dataset of Indian names created using state-of-the-art language models (Llama-3.2-11B-Vision-Instruct and OpenAI ChatGPT-4 v2.0).
## Installation
Install the package directly using pip:
```bash
pip install indian-name-maker
```
## Usage
### Python API
```python
from indian_name_maker import NameGenerator
# Create a name generator instance
generator = NameGenerator()
# Generate a random first name
first_name = generator.get_first_name()
print(f"First Name: {first_name}")
# Generate a random last name
last_name = generator.get_last_name()
print(f"Last Name: {last_name}")
# Generate a random full name
full_name = generator.get_full_name()
print(f"Full Name: {full_name}")
# Generate multiple full names
names = generator.get_multiple_names(count=5)
print(f"Multiple Names: {names}")
# Generate names with custom separator
custom_name = generator.get_full_name(separator="-")
print(f"Custom Separated Name: {custom_name}")
```
### Command Line Interface
```bash
# Generate a single full name
generate-indian-name
# Generate multiple names
generate-indian-name --count 5
# Generate first names only
generate-indian-name --first-only --count 3
# Generate with custom separator
generate-indian-name --separator "-"
```
## Features
- Generate random Indian first names
- Generate random Indian last names
- Generate random full names (combination of first and last names)
- Generate multiple names at once
- Command-line interface for easy access
- Based on a synthetically generated dataset of Indian names
## Dataset
The name dataset is synthetically generated using:
- Llama-3.2-11B-Vision-Instruct model (Hugging Face)
- OpenAI ChatGPT-4 (v2.0)
This ensures:
- Diverse name combinations
- Culturally appropriate naming patterns
## License
This project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).
You are free to:
- Share — copy and redistribute the material in any medium or format
- Adapt — remix, transform, and build upon the material
Under the following terms:
- **Attribution** — You must give appropriate credit, provide a link to the license, and indicate if changes were made.
- **NonCommercial** — You may not use the material for commercial purposes.
- **ShareAlike** — If you remix, transform, or build upon the material, you must distribute your contributions under the same license.
For more details, see the [LICENSE](LICENSE) file or visit [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)
Raw data
{
"_id": null,
"home_page": null,
"name": "indian-name-maker",
"maintainer": null,
"docs_url": null,
"requires_python": ">=3.7",
"maintainer_email": null,
"keywords": "indian, names, generator",
"author": "Ankit Kumar",
"author_email": null,
"download_url": "https://files.pythonhosted.org/packages/da/d3/4fc0dbafeb3faee7c3c61a5ed67926765dce4cb3742978399b72190a4ba2/indian_name_maker-0.1.4.tar.gz",
"platform": null,
"description": "# Indian Name Maker\r\n\r\nA Python package to generate Indian names. The package uses a synthetically generated dataset of Indian names created using state-of-the-art language models (Llama-3.2-11B-Vision-Instruct and OpenAI ChatGPT-4 v2.0).\r\n\r\n## Installation\r\n\r\nInstall the package directly using pip:\r\n```bash\r\npip install indian-name-maker\r\n```\r\n\r\n## Usage\r\n\r\n### Python API\r\n```python\r\nfrom indian_name_maker import NameGenerator\r\n\r\n# Create a name generator instance\r\ngenerator = NameGenerator()\r\n\r\n# Generate a random first name\r\nfirst_name = generator.get_first_name()\r\nprint(f\"First Name: {first_name}\")\r\n\r\n# Generate a random last name\r\nlast_name = generator.get_last_name()\r\nprint(f\"Last Name: {last_name}\")\r\n\r\n# Generate a random full name\r\nfull_name = generator.get_full_name()\r\nprint(f\"Full Name: {full_name}\")\r\n\r\n# Generate multiple full names\r\nnames = generator.get_multiple_names(count=5)\r\nprint(f\"Multiple Names: {names}\")\r\n\r\n# Generate names with custom separator\r\ncustom_name = generator.get_full_name(separator=\"-\")\r\nprint(f\"Custom Separated Name: {custom_name}\")\r\n```\r\n\r\n### Command Line Interface\r\n```bash\r\n# Generate a single full name\r\ngenerate-indian-name\r\n\r\n# Generate multiple names\r\ngenerate-indian-name --count 5\r\n\r\n# Generate first names only\r\ngenerate-indian-name --first-only --count 3\r\n\r\n# Generate with custom separator\r\ngenerate-indian-name --separator \"-\"\r\n```\r\n\r\n## Features\r\n\r\n- Generate random Indian first names\r\n- Generate random Indian last names\r\n- Generate random full names (combination of first and last names)\r\n- Generate multiple names at once\r\n- Command-line interface for easy access\r\n- Based on a synthetically generated dataset of Indian names\r\n\r\n## Dataset\r\n\r\nThe name dataset is synthetically generated using:\r\n- Llama-3.2-11B-Vision-Instruct model (Hugging Face)\r\n- OpenAI ChatGPT-4 (v2.0)\r\n\r\nThis ensures:\r\n- Diverse name combinations\r\n- Culturally appropriate naming patterns\r\n\r\n## License\r\n\r\nThis project is licensed under the Creative Commons Attribution-NonCommercial-ShareAlike 4.0 International License (CC BY-NC-SA 4.0).\r\n\r\nYou are free to:\r\n- Share \u2014 copy and redistribute the material in any medium or format\r\n- Adapt \u2014 remix, transform, and build upon the material\r\n\r\nUnder the following terms:\r\n- **Attribution** \u2014 You must give appropriate credit, provide a link to the license, and indicate if changes were made.\r\n- **NonCommercial** \u2014 You may not use the material for commercial purposes.\r\n- **ShareAlike** \u2014 If you remix, transform, or build upon the material, you must distribute your contributions under the same license.\r\n\r\nFor more details, see the [LICENSE](LICENSE) file or visit [CC BY-NC-SA 4.0](https://creativecommons.org/licenses/by-nc-sa/4.0/)\r\n",
"bugtrack_url": null,
"license": "CC BY-NC-SA 4.0",
"summary": "A Python package to generate Indian names",
"version": "0.1.4",
"project_urls": null,
"split_keywords": [
"indian",
" names",
" generator"
],
"urls": [
{
"comment_text": "",
"digests": {
"blake2b_256": "11e8e95b04b57b5ae0a8381aead41c174df7a06c2536309768af7afd3cf5e8eb",
"md5": "0e5744942577819329ec217c72f82266",
"sha256": "35850616230a7dee6379a6d0e74e11a821aae780b87823c80aa01888691ade63"
},
"downloads": -1,
"filename": "indian_name_maker-0.1.4-py3-none-any.whl",
"has_sig": false,
"md5_digest": "0e5744942577819329ec217c72f82266",
"packagetype": "bdist_wheel",
"python_version": "py3",
"requires_python": ">=3.7",
"size": 13982,
"upload_time": "2024-11-21T19:00:50",
"upload_time_iso_8601": "2024-11-21T19:00:50.217659Z",
"url": "https://files.pythonhosted.org/packages/11/e8/e95b04b57b5ae0a8381aead41c174df7a06c2536309768af7afd3cf5e8eb/indian_name_maker-0.1.4-py3-none-any.whl",
"yanked": false,
"yanked_reason": null
},
{
"comment_text": "",
"digests": {
"blake2b_256": "dad34fc0dbafeb3faee7c3c61a5ed67926765dce4cb3742978399b72190a4ba2",
"md5": "2f9552f00dd701c70e1fd297ab1aa05f",
"sha256": "12ee5e2de18acf4ade6e375f636c815ec4a403d06df3de55b7408a95a9f0193d"
},
"downloads": -1,
"filename": "indian_name_maker-0.1.4.tar.gz",
"has_sig": false,
"md5_digest": "2f9552f00dd701c70e1fd297ab1aa05f",
"packagetype": "sdist",
"python_version": "source",
"requires_python": ">=3.7",
"size": 15651,
"upload_time": "2024-11-21T19:00:51",
"upload_time_iso_8601": "2024-11-21T19:00:51.332974Z",
"url": "https://files.pythonhosted.org/packages/da/d3/4fc0dbafeb3faee7c3c61a5ed67926765dce4cb3742978399b72190a4ba2/indian_name_maker-0.1.4.tar.gz",
"yanked": false,
"yanked_reason": null
}
],
"upload_time": "2024-11-21 19:00:51",
"github": false,
"gitlab": false,
"bitbucket": false,
"codeberg": false,
"lcname": "indian-name-maker"
}
JSON