---
name: "faker"
section: "1"
platform: "linux"
package: "faker"
version: "33.3.1-1"
release: "Debian 13 (Trixie)"
platforms: ["linux"]
url: "https://new.carta.tech/faker"
---

# faker(1)

command to generate fake data

## NAME

faker - command to generate fake data

## DESCRIPTION

usage: faker \[-h\] \[--version\] \[-v\] \[-o output\] \[-l LOCALE\] \[-r REPEAT\]

-

  \[-s SEP\] \[--seed SEED\] \[-i \[INCLUDE ...\]\] \[fake\] \[fake argument ...\]

faker version 33.3.1

### positional arguments:

- fake

  name of the fake to generate output for (e.g. profile)

- fake argument

  optional arguments to pass to the fake (e.g. the profile fake takes an optional list of comma separated field names as the first argument)

### options:

- **-h**, **--help**

  show this help message and exit

- **--version**

  show program's version number and exit

- **-v**, **--verbose**

  show INFO logging events instead of CRITICAL, which is the default. These logging events provide insight into localization of specific providers.

- **-o** output

  redirect output to a file

- **-l**, **--lang** LOCALE

  specify the language for a localized provider (e.g. de\_DE)

- **-r**, **--repeat** REPEAT

  generate the specified number of outputs

- **-s**, **--sep** SEP

  use the specified separator after each output

- **--seed** SEED

  specify a seed for the random generator so that results are repeatable. Also compatible with 'repeat' option

- **-i**, **--include** \[INCLUDE ...\]

  list of additional custom providers to user, given as the import path of the module containing your Provider class (not the provider class itself)

supported locales:

-

  ar\_AA, ar\_AE, ar\_BH, 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, dk\_DK, el\_CY, el\_GR, en, en\_AU, en\_BD, en\_CA, en\_GB, en\_IE, en\_IN, en\_MS, 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\_FR, fr\_QC, ga\_IE, gu\_IN, he\_IL, hi\_IN, hr\_HR, hu\_HU, hy\_AM, id\_ID, it\_CH, it\_IT, ja\_JP, ka\_GE, ko\_KR, la, lb\_LU, lt\_LT, lv\_LV, mt\_MT, ne\_NP, 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 is supported by at least one of the providers.

-

  \- for this user, the default locale is en\_US.

-

  If the optional argument locale and/or user's default locale is not 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;