McBarnag

Markov-chain-Based random name generator

---

Another one of these random name generators that employs Markov-chains to create random names and curious accidents from training data. This one has nothing extraordinary going on, and you can probably find better and more versatile implementations out there. But this one is mine.

Note

This is a very rudimentary project, and hence a very rudimentary README. This project is not meant for professional use, and can at best serve educational purposes. Feel free to browse the code, but don't expect too much in terms of complexity.

Usage

Installation

The code runs directly, no fancy installation required. Clone the repository anywhere onto your machine using

git clone https://github.com/MilanStaffehl/McBarnag.git

or

git clone git@github.com:MilanStaffehl/McBarnag.git

or download it directly as a .zip file from the GitHub page. McBarnag has no third-party requirements and runs on all versions of Python 3.12 and higher.

Usage

In the cloned repository, you can run the generate.py script to get some random names. Type

python generate.py -h

to view the help text for the script. It tells you how to use the current version of the script best.

Roadmap

This project was more of a proof-of-concept and a fun afternoon project. I don't expect to work much more on it, but the few things that came to mind and that would be nice to test are gathered in the GitHub issues of the project.

License

This project is licensed under the MIT license.

Acknowledgements

This project uses training data from publicly available sources:

• The list of city names is from the "World Cities Database" by simplemaps.com, licensed under CC BY 4.0.
• The list of greek mythological is from "List of Greek Gods and Goddesses" by Katrina Pettitt, licensed under the MIT license.

This project was largely inspired by an article by Ben Hoyt and shaped by a similar implementation displayed on RogueBasin.