FAKER(1)

👑 FAKER(1) — the faker command, aka ur personal fake-data bestie

User Commands · faker 39.0.0 ✨

---

🌸 NAME

faker — the command that generates fake data, no cap 💅

---

🦋 DESCRIPTION

okay so. bestie. imagine needing a whole fake person's address, ssn, birthday, whatever, and not wanting to hand-make it. that's literally what this does.

here's the whole vibe of how u call it:

usage: faker [-h] [--version] [-v] [-o output] [-l LOCALE] [-r REPEAT]
       [-s SEP] [--seed SEED] [-i [INCLUDE ...]] [fake] [fake argument ...]

faker version 39.0.0 🎀

---

✨ positional arguments: ✨

• fake — the name of the fake u want output for (like profile, yk)
• fake argument — optional extra args u pass along to the fake. for example, the profile fake takes an optional list of comma-separated field names as its first argument 🍓

---

💖 options: 💖

• -h, --help — shows this help message and dips out. iconic behavior.
• --version — shows the program's version number and exits. periodt.
• -v, --verbose — shows INFO logging events instead of CRITICAL, which is the default. these logging events give u the tea on how specific providers get localized 🔍
• -o output — redirects the output into a file
• -l, --lang LOCALE — tells it which language to use for a localized provider (like de_DE)
• -r, --repeat REPEAT — generates the number of outputs u specified
• -s, --sep SEP — puts the separator u chose after each output
• --seed SEED — gives the random generator a seed so the results are repeatable. also works together with the repeat option 🎲
• -i, --include [INCLUDE ...] — a list of extra custom providers to use, handed over as the import path of the module that contains ur Provider class (not the provider class itself, bestie, that distinction matters 😭)

---

🌈 supported locales: 🌈

like, all of these:

ar_AA, ar_AE, ar_BH, ar_DZ, ar_EG, ar_JO, ar_PS, ar_SA, az_AZ,
bg_BG, bn_BD, bs_BA, cs_CZ, da_DK, de, de_AT, de_CH, de_DE,
de_LI, de_LU, dk_DK, el_CY, el_GR, en, en_AU, en_BD, en_CA,
en_GB, en_IE, en_IN, en_KE, en_MS, en_NG, en_NZ, en_PH, en_PK,
en_TH, en_US, es, es_AR, es_CA, es_CL, es_CO, es_ES, es_MX,
et_EE, fa_IR, fi_FI, fil_PH, fr_BE, fr_CA, fr_CH, fr_DZ, fr_FR,
fr_QC, ga_IE, gu_IN, ha_NG, he_IL, hi_IN, hr_HR, hu_HU, hy_AM,
id_ID, ig_NG, is_IS, it_CH, it_IT, ja_JP, ka_GE, ko_KR, la,
lb_LU, lt_LT, lv_LV, mt_MT, ne_NP, ng_NG, nl_BE, nl_NL, no_NO,
or_IN, pl_PL, pt_BR, pt_PT, ro_RO, ru_RU, sk_SK, sl_SI, sq_AL,
sv_SE, sw, ta_IN, th, th_TH, tl_PH, tr_TR, tw_GH, uk_UA, uz_UZ,
vi_VN, yo_NG, zh_CN, zh_TW, zu_ZA

Faker can take a locale as an optional argument, to return localized data. if no locale argument is specified, the factory falls back to the user's OS locale, as long as it's supported by at least one of the providers.

• for this user, the default locale is en_US ✨

If the optional argument locale and/or the user's default locale isn't available for the specified provider, the factory falls back to faker's default locale, which is en_US.

---

🫶 examples: 🫶

$ faker address

968 Bahringer Garden Apt. 722 Kristinaland, NJ 09890

$ faker -l de_DE address

Samira-Niemeier-Allee 56 94812 Biedenkopf

$ faker profile ssn,birthdate

{'ssn': u'628-10-1085', 'birthdate': '2008-03-29'}

$ faker -r=3 -s=";" name

Willam Kertzmann; Josiah Maggio; Gayla Schmitt;

---

ngl if u made it all the way down here, ur the main character of this manpage. go generate some fake data, u deserve it 💜

---

faker 39.0.0 · December 2025 — mwah, that's the version and the date, ty for coming to my ted talk 🎀🦋✨