{"id":34103522,"url":"https://github.com/a-tsagkalidis/fictional_names_package","last_synced_at":"2025-12-14T17:42:42.720Z","repository":{"id":177071170,"uuid":"659293883","full_name":"a-tsagkalidis/fictional_names_package","owner":"a-tsagkalidis","description":"A Python package for generating fictional names for characters in your fantasy stories, Dungeons \u0026 Dragons, RPGs, or whatever else you need them for.","archived":false,"fork":false,"pushed_at":"2025-01-06T15:51:19.000Z","size":983,"stargazers_count":5,"open_issues_count":0,"forks_count":3,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-21T04:59:33.357Z","etag":null,"topics":["dnd5e-tools","dungeons-and-dragons","fantasy","fictional-names","module-python","name-generator","names","pypi-package","python","ttrpg"],"latest_commit_sha":null,"homepage":"https://pypi.org/project/fictional-names/","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/a-tsagkalidis.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-06-27T14:21:54.000Z","updated_at":"2025-06-17T03:37:09.000Z","dependencies_parsed_at":null,"dependency_job_id":"f82daa01-f3ab-4af8-afbb-dc5e93ad7520","html_url":"https://github.com/a-tsagkalidis/fictional_names_package","commit_stats":null,"previous_names":["a-tsagkalidis/fictional_names_package"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/a-tsagkalidis/fictional_names_package","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tsagkalidis%2Ffictional_names_package","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tsagkalidis%2Ffictional_names_package/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tsagkalidis%2Ffictional_names_package/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tsagkalidis%2Ffictional_names_package/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/a-tsagkalidis","download_url":"https://codeload.github.com/a-tsagkalidis/fictional_names_package/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/a-tsagkalidis%2Ffictional_names_package/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":27732629,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-12-14T02:00:11.348Z","response_time":56,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["dnd5e-tools","dungeons-and-dragons","fantasy","fictional-names","module-python","name-generator","names","pypi-package","python","ttrpg"],"created_at":"2025-12-14T17:42:42.137Z","updated_at":"2025-12-14T17:42:42.701Z","avatar_url":"https://github.com/a-tsagkalidis.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Fictional Names\n\n[![PyPI version](https://d25lcipzij17d.cloudfront.net/badge.svg?id=py\u0026r=r\u0026ts=1683906897\u0026type=6e\u0026v=1.0.0\u0026x2=0)](https://pypi.org/project/fictional-names/)\n\nA Python package for generating fictional names for characters in your fantasy stories, Dungeons \u0026 Dragons, RPGs, or whatever else you need them for.\n\n## Installation\n\n```bash\npython3 -m pip install fictional_names\n```\n## Usage\n\nThe generate_name function is the main function of the package, and it can be used in a variety of ways, by passing different arguments to it. It takes the following arguments: `gender`, `style`, and `library`.\n\n**`gender`** can be either `'male'` or`'female'`. Leave it blank if you want random gender.\n\n**`style`** can be any of the following: `'arab'`, `'aztec'`, `'chinese'`, `'dragonborn'`, `'drow'`, `'dwarven'`, `'elven'`, `'english'`, `'eriskon'`, `'germanic'`, `'giant'`, `'gnomish'`, `'greek'`, `'halfling'`, `'human'`, `'japanese'`, `'jordan'`, `'martin'`, `'mongolian'`, `'norsemen'`, `'orc'`, `'roman'`, `'rowling'`, `'sapkowski'`, `'slavic'`, `'steampunk'`, `'tolkien'`, `'turkish'`, or `'viking'`. Leave it blank if you want a random style.\n\n**Most styles are obvious, but some of them are named after famous authors, and some of them are named after famous fantasy races.*\n\n**`library`** can be either `True` or `False`. Leave it blank and it's randomly picked. \n\n*`True` *libraries are used to generate solid names that resembling real names, or names that is more likely to have been used in books, movies, or TV shows.* `False` *libraries are used to generate more unique names as they are compounded by random syllables, related to the* `style`.\n\n## Importing the package\n```python\nfrom fictional_names import name_generator\nnames = name_generator.generate_name\n```\n\nWhat it follows is a list of examples of how to use the function, and what you can expect to get from it.\n\n## Completely random names\n```python\nnames()\n# Probable generated names: 'Eleanor Neumann', 'Nathaniel Eberhardt', 'Yolotzintli (Ethereal Mist)', 'Isabeau of Rhovanion', 'Barthanes al'Tealdar', 'Arabella Bryce', 'Sicilia Lucretillus', 'Orggol the Ruiner', 'Bolbo Honeydew', 'Gerda Einarsdottir', 'Ganoes Untor'\n```\n\n## Human names from different cultures\n```python\nnames(style='english')\n# Probable generated names: 'Aaron Mckinney', 'Edmund Sheffield', 'Beatrix Moss'\n\nnames(style='arab')\n# Probable generated names: 'Youssef Shihab', 'Yasmin Fadel', 'Saeed Nader'\n\nnames(style='chinese')\n# Probable generated names: 'Xiulan Tang', 'Guo Qing', 'Mei Chi'\n\nnames(style='germanic')\n# Probable generated names: 'Dankrich Vogelweber', 'Folker Holz', 'Siegfried Wiedemann'\n\nnames(style='japanese')\n# Probable generated names: 'Yumiko Yoshikawa', 'Naoki Yamamoto', 'Ryozo Nagano'\n\nnames(style='slavic')\n# Probable generated names: 'Valentin Marinov', 'Pavelv Borenko', 'Zina Kovačević'\n```\n## Human names from lost civilizations\n```python\nnames(style='aztec')\n# Probable generated names: 'Miquiztli (Lorekeeper)', 'Huexotzinco (Silver Mist)', 'Callitli Tlanitl'\n\nnames(style='greek', library=True)\n# Probable generated names: 'Demosthenes of Kydonia', 'Adrastos of Apollonia', 'Kallisto of Larissa'\n\nnames(style='roman')\n# Probable generated names: 'Faucia Vitruvius', 'Atia Tiberius', 'Aventinus Calpurnius'\n\nnames(style='viking')\n# Probable generated names: 'Ørvar Yvngirsson', 'Livþora Jarmann', 'Siggyða Norrav'\n```\n\n## Fantasy names based on Dungeons \u0026 Dragons and other TTRPGs\n```python\nnames(gender='male', style='dwarven', library=False)\n# Probable generated names: 'Kazdin Voldurmir', 'Thunûr Kinmarmak', 'Dorgǎrn Bǎlthrak'\n\nnames(gender='female', style='elven', library=True)\n# Probable generated names: 'Galadhrim Narothor', 'Narwindë Ardalas', 'Ermalinde Nimrith'\n\nnames(style='halfling', library=True)\n# Probable generated names: 'Lyric Tricklebrook', 'Nibs Cobblehill', 'Sylvia Wildflower'\n\nnames(gender='male', style='human', library=True)\n# Probable generated names: 'Leander Hecht', 'Jasper Hahn', 'Galahad Thiele'\n\nnames(gender='male', style='orc', library=True)\n# Probable generated names: 'Snagrag the Desecrator', 'Bolgrag the Crazed', 'Thak the Deathbringer'\n\nnames(gender='female', style='steampunk', library=True)\n# Probable generated names: 'Dorothea Finnigan', 'Bernadette Baron', 'Mathilda Tarleton'\n```\n\n## Human names based on famous authors works\n```python\nnames(gender='male', style='tolkien', library=True)\n# Probable generated names: 'Saradoc of Bree', 'Eldric of Rohan', 'Hilbert of Dol Guldur'\n\nnames(style='martin', library=False)\n# Probable generated names: 'Bran Conford', 'Toras Belton', 'Sen Berdon'\n\nnames(gender='female', style='rowling', library=False)\n# Probable generated names: 'Sega Ryddle', 'Alda Glanvill', 'Kiola Graham'\n```\n\n## Printing the name\nYou can print the name directly from the function, or you can store it in a variable and print it later.\n```python\nprint(names())\n```\nor\n```python\nname = names()\nprint(name)\n```","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-tsagkalidis%2Ffictional_names_package","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fa-tsagkalidis%2Ffictional_names_package","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fa-tsagkalidis%2Ffictional_names_package/lists"}