Skip to content

nellyvo/random_name

 
 

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

13 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Random Name Generator

A simple web application that generates names randomly using a Markov model, based on existing lists of first and last names.

Requirements

  • Python
  • flask

Installation

Step 1: Create a virtual environment (recommended)

python -m venv venv
source venv/bin/activate # On macOS/Linux
venv\Scripts\activate.bat # On Windows

Step 2: Install Flask

pip install flask

Running the Application

python run.py
Then open your browser and go to:
http://127.0.0.1:5000/

Project Structure

random_name/

├── app/ # Core application logic
│ ├── init.py # Flask app initialization
│ ├── data_loader.py # Loads name data
│ ├── generator.py # Random name generation
│ ├── routes.py # Flask routes (web pages)
│ └── syllables.py # Syllable handling

├── data/ # Name data files
│ ├── noms_famille.txt
│ ├── prenoms_filles.txt
│ └── prenoms_garcons.txt

├── static/ # CSS and JS assets
│ ├── css/style.css
│ └── js/script.js

├── templates/ # HTML templates
│ └── index.html

├── run.py # Main entry point
├── scrap.py # Name scraping script
├── NOMS.py # Testing or processing script
├── ameliorer.txt # Improvement notes
└── README.md

About

random name with model markov

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages

  • Python 83.4%
  • HTML 9.2%
  • CSS 4.3%
  • JavaScript 3.1%