Skip to main content

Mimesis: fake data generator.

Project description

Mimesis - Fake Data Generator


Travis CI Documentation Status Code Coverage Package version Python version

Mimesis is a package for Python, which helps generate big volumes of fake data for a variety of purposes in a variety of languages. The fake data could be used to populate a testing database, create beautiful JSON and XML files, anonymize data taken from production and etc.


To install mimesis, simply use pip:

[env] ~ ⟩ pip install mimesis

Getting started

This library is really easy to use and everything you need is just import an object which represents a type of data you need (we call such object Provider).

In example below we import provider Person, which represents data related to personal information, such as name, surname, email and etc:

>>> from mimesis import Person
>>> person = Person('en')

>>> person.full_name()
'Antonetta Garrison'

>>> person.occupation()
'Backend Developer'

>>> person.telephone()

More about the other providers you can read in our documentation.


Mimesis currently includes support for 33 different locales. You can specify a locale when creating providers and they will return data that is appropriate for the language or country associated with that locale.

Let’s take a look how it works:

>>> from mimesis import Person
>>> from mimesis.enums import Gender

>>> de = Person('de')
>>> en = Person('en')

>>> de.full_name(gender=Gender.FEMALE)
'Sabrina Gutermuth'

>>> en.full_name(gender=Gender.MALE)
'Layne Gallagher'


Mimesis support over twenty different data providers available, which can produce data related to people, food, computer hardware, transportation, addresses, and more.

See API Reference for more info.

Generating structured data

You can generate dictionaries which can be easily converted to any format you want (JSON/XML/YAML etc.) with any structure you want.

Just use object Field() as shown below:

>>> from mimesis.schema import Field, Schema
>>> from mimesis.enums import Gender
>>> _ = Field('en')
>>> description = (
...     lambda: {
...         'id': _('uuid'),
...         'name': _('text.word'),
...         'version': _('version', pre_release=True),
...         'timestamp': _('timestamp', posix=False),
...         'owner': {
...             'email': _('', key=str.lower),
...             'token': _('token_hex'),
...             'creator': _('full_name', gender=Gender.FEMALE),
...         },
...     }
... )
>>> schema = Schema(schema=description)
>>> schema.create(iterations=1)


    'id': '7a41f446-57a8-ec17-b9ad-367742251679',
    'name': 'desert',
    'version': '7.3.7-alpha.6',
    'timestamp': '2026-06-06T14:00:52Z',
    'owner': {
      'email': '',
      'token': 'acfd799af9b46e5560a51dabace593033171ec81e997905acfc602c93a741735',
      'creator': 'Keena Hendricks'

See Schema and Fields for more info.


You can find the complete documentation on the Read the Docs.

It is divided into several sections:

You can improve it by sending pull requests to this repository.

How to Contribute

  1. Take a look at contributing guidelines.
  2. Check for open issues or open a fresh issue to start a discussion around a feature idea or a bug.
  3. Fork the repository on GitHub to start making your changes to the your_branch branch.
  4. Add yourself to the list of contributors.
  5. Send a pull request and bug the maintainer until it gets merged and published.


Mimesis is licensed under the MIT License. See LICENSE for more information.

Project details

Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Files for mimesis, version 4.0.0
Filename, size File type Python version Upload date Hashes
Filename, size mimesis-4.0.0-py3-none-any.whl (2.8 MB) File type Wheel Python version py3 Upload date Hashes View
Filename, size mimesis-4.0.0.tar.gz (2.7 MB) File type Source Python version None Upload date Hashes View

Supported by

Pingdom Pingdom Monitoring Google Google Object Storage and Download Analytics Sentry Sentry Error logging AWS AWS Cloud computing DataDog DataDog Monitoring Fastly Fastly CDN DigiCert DigiCert EV certificate StatusPage StatusPage Status page