1 files changed, 65 insertions, 0 deletions
diff --git a/Userenum/README.MD b/Userenum/README.MD
new file mode 100644
index 0000000..beba07b
--- /dev/null
+++ b/Userenum/README.MD
@@ -0,0 +1,65 @@
+# 📄 README.md
+
+# Username Variation Generator
+
+A lightweight Python tool to generate common username formats used in AD, Linux, and corporate environments. Useful for enumeration during pentesting or automation.
+
+---
+
+## ✨ Features
+
+* Accepts **First Last** and **First.Last** formats
+* Generates multiple username variations
+* Supports custom input/output files
+* Removes duplicates automatically
+
+---
+
+## 🚀 Usage
+
+### Basic
+
+```bash
+python3 gen_user.py -i names.txt
+```
+
+### Specify output file
+
+```bash
+python3 gen_user.py -i names.txt -o users_final.txt
+```
+
+### Help
+
+```bash
+python3 gen_user.py -h
+```
+
+---
+
+## 📝 Input Examples
+
+```
+James Roberts
+Sarah.Osvald
+```
+
+---
+
+## 📤 Output Examples
+
+```
+james.roberts
+jroberts
+jamesr
+james_roberts
+jr
+```
+
+---
+
+## 👤 Authors
+
+PaiN05, Uday
+
+---