NewYour coding agent can read the release notes before it upgrades.Set up the MCP server →
PyPI · #398 most downloaded on PyPI
Faker is a Python package that generates fake data for you.
Last release 4 days ago
29 Sep 2026
Ships fairly regularly
a new release about every 2 weeks
Nearly every release is documented
notes for 60 of the last 60 stable releases
Nothing withdrawn
no release was ever pulled
16 years old
507 releases · first in 2010
See CHANGELOG.md.
See CHANGELOG.md.
One column per quarter.
de_DE and de_AT. Thanks @@Kalbra.See CHANGELOG.md.
See CHANGELOG.md.
os.urandom in binary() if unseeded. Thanks @AlmightyYakob.See CHANGELOG.md.
See CHANGELOG.md.
See CHANGELOG.md.
es_ES locale. Thanks @mondeja.See CHANGELOG.md.
See CHANGELOG.md.
See CHANGELOG.md.
Add cities to de_CH. Thanks @Kalbra.
de_CH. Thanks @Kalbra.Set correct language on provider when specific locale is requested. Thanks @interDist.
Remove empty string in Korean job list. Thanks @georgidimitrov-hs.
Remove dependency from `text-unidecode`.
text-unidecode.Add geonames db of Italian cap-city-province and full match when generating full addresses. Thanks @FrancYescO.
Add banks for fa-ir. Thanks @arminshoughi.
fa-ir. Thanks @arminshoughi.Improve phone numbers for it_IT. Thanks @FrancYescO.
it_IT. Thanks @FrancYescO.Add providers for az_AZ locale. Thanks @sevdimali.
az_AZ locale. Thanks @sevdimali.Replace lorempixel.com service with picsum.photos in image_url provider.
lorempixel.com service with picsum.photos in image_url provider.placeholder_url argument to image_url.Deprecate positional allowed_types.
allowed_types.Revert "deprecate positional allowed_types".
allowed_types".deprecate positional allowed_types (#1573). Thanks @fcurella.
allowed_types (#1573). Thanks @fcurella.* Fix positional value_types.
value_types.Shorten IBANs for pl_PL to 28 chars. Fix #1568 (#1569). Thanks @fcurella.
pl_PL to 28 chars. Fix #1568 (#1569). Thanks @fcurella.Relax ElementsType to admit e.g. Sets. Thanks @OJFord.
Fix pydecimal with left_digits=0 not setting the left digit to 0. Thanks @ndrwkim.
pydecimal with left_digits=0 not setting the left digit to 0. Thanks @ndrwkim.Add es_CO localized providers. Thank you @healarconr.
es_CO localized providers. Thank you @healarconr.Take into account area codes for French phone numbers. Thanks @nicarl.
Add provider for French SSN. Thanks @nicarl.
Add dynamic provider. Thanks @omri374.
Improve randomness of pydecimal for different scenarios. Thanks @antonioIrizar.
pydecimal for different scenarios. Thanks @antonioIrizar.Limit typing_extensions dependency to Python < 3.8. Thanks @mgorny.
typing_extensions dependency to Python < 3.8. Thanks @mgorny.Add typing-extensions as dependency and pin mypy version. Thanks @nicarl.
typing-extensions as dependency and pin mypy version. Thanks @nicarl.Add automotive provider for nl_NL. Thanks @MarcelRobeer.
nl_NL. Thanks @MarcelRobeer.Add Typing. Thanks @MarcelRobeer, @nicarl.
Change to secondary address format in en_AU locale to reflect the common usage. Thanks @deboraelkin2.
en_AU locale to reflect the common usage. Thanks @deboraelkin2.Add currency, automotive, company and bank providers for el_GR. Thanks @nikosmichas.
currency, automotive, company and bank providers for el_GR. Thanks @nikosmichas.Add color and date_time provider for el_GR. Thanks @nikosmichas.
color and date_time provider for el_GR. Thanks @nikosmichas.Add currency provider for nl_NL. Thanks @MarcelRobeer.
nl_NL. Thanks @MarcelRobeer.Fix pydecimal returning min_value or max_value too frequently. Thanks @zivkovic.
pydecimal returning min_value or max_value too frequently. Thanks @zivkovic.Change default email generator to use safe domain names. Thanks @errbufferoverfl.
Add date_time provider for nl_NL. Thanks @MarcelRobeer.
date_time provider for nl_NL. Thanks @MarcelRobeer.Add bg_BG color provider. Thanks @iradonov.
bg_BG color provider. Thanks @iradonov.Fix bug in pydecimal when returning max/min. Thanks @wilbertom.
pydecimal when returning max/min. Thanks @wilbertom.Fix pydecimal precision. Thanks @joidegn.
pydecimal precision. Thanks @joidegn.Add datetime provider for bn_BD. Thanks @jabertuhin.
bn_BD. Thanks @jabertuhin.Nothing published for this version
Change fi_FI Provinces to Regions. Thanks @LKajan.
fi_FI Provinces to Regions. Thanks @LKajan.uk_UA address provider - fix streets and cities names, added regions. Thanks @o-vasyliev.
uk_UA address provider - fix streets and cities names, added regions. Thanks @o-vasyliev.Fix missing underscores in mac_platform_token. Thanks @iamkeyur.
mac_platform_token. Thanks @iamkeyur.Remove period/fullstop from en_GB prefixes. Thanks @stephengruppetta.
en_GB prefixes. Thanks @stephengruppetta.Add missing diacritics in fr_FR person provider. Thanks @laowantong.
fr_FR person provider. Thanks @laowantong.Added non-geo numbers and services phones format for pt_BR. Thanks @leogregianin.
pt_BR. Thanks @leogregianin.pt_BR. Thanks @leogregianin.pt_BR. Thanks @leogregianin.Add nic_handle. Thanks @pishchalnikov.
nic_handle. Thanks @pishchalnikov.Remove potentially offensive surname in it_IT. Thanks @lordgordon.
it_IT. Thanks @lordgordon.Return list instead of tuple in choices_distribution. Thanks @svisser.
choices_distribution. Thanks @svisser.Enable faker instances to be unpickled (#1480). Thanks @fcurella.
Add ar_AE (UAE) phone numbers. Thanks @sshishov.
ar_AE (UAE) phone numbers. Thanks @sshishov.Skip UnsupportedFeature's on the command line. Thanks @therefromhere.
Add RIPE ID. Thanks @pishchalnikov.
Avoid collision for date in datetime provider. Thanks @mattshin.
date in datetime provider. Thanks @mattshin.Fix left_digits ignored if min_value is given. Thanks @OJFord.q
left_digits ignored if min_value is given. Thanks @OJFord.qAdd iana_id, IANA Registrar ID. Thanks @pishchalnikov.
iana_id, IANA Registrar ID. Thanks @pishchalnikov.Your coding agent can read these notes before it upgrades. Set up the MCP server →