Repolode
Submit
lk-geimfari

lk-geimfari/mimesis

A Python library that generates fake but realistic data such as names, addresses, emails and financial values across 47 locales.

View on GitHubWebsite
Stars
4,864
Forks
372
Open issues
12
Last commit
4 days ago

What is it?

Mimesis is a Python library for producing fake but realistic test data. It provides data providers for categories such as personal information, addresses, dates, phone numbers, emails and financial values, and the output follows the conventions of the selected locale.

Developers typically use it to populate test databases, mock API responses, generate JSON or XML fixtures, build sample datasets, or anonymize production data. Schema-based generators and relational data generation let users describe structured records, including foreign keys and nested objects, in a single definition. A factory_boy integration is also available.

The library is installed with pip and supports Python 3.10 and later. Its API is fully typed, so editors can offer autocompletion for providers and methods.

Key features

  • 01Supports 47 locales for region-specific names, addresses and formats.
  • 02Provides data providers for personal, address, date, financial and other common data types.
  • 03Generates structured records with schema-based generators.
  • 04Supports relational datasets with foreign keys and nested schemas.
  • 05Allows custom data providers and field handlers.
  • 06Fully typed API with editor autocompletion.

Use cases

  • Populating development or test databases with realistic records.
  • Mocking API responses or generating JSON and XML fixtures.
  • Creating sample datasets for demos, analysis or prototyping.
  • Anonymizing production data before sharing it with other teams.

Quick start

  1. 1

    Install Mimesis from PyPI with pip

    pip install mimesis
  2. 2

    Import the Person provider and a locale, then generate a full name

    python -c "from mimesis import Person; from mimesis.locales import Locale; print(Person(Locale.EN).full_name())"

In collections

Testing frameworks & test automation tools

Topics

#fake-data#test-data#python#data-generation#synthetic-data#testing#mock-data#data#dataframe#datascience

FAQ

What is mimesis?
A Python library that generates fake but realistic data such as names, addresses, emails and financial values across 47 locales. Mimesis is a Python library for producing fake but realistic test data. It provides data providers for categories such as personal information, addresses, dates, phone numbers, emails and financial values, and the output follows the conventions of the selected locale.
Is mimesis free to use? What license does it have?
mimesis is open source under the MIT license. Check the license terms before using it in commercial products.
Is mimesis still maintained?
Actively maintained. The last commit to mimesis was on Nov 3, 2026.
What can I use mimesis for?
Populating development or test databases with realistic records. Mocking API responses or generating JSON and XML fixtures. Creating sample datasets for demos, analysis or prototyping. Anonymizing production data before sharing it with other teams.
How do I install mimesis?
Install Mimesis from PyPI with pip: pip install mimesis Import the Person provider and a locale, then generate a full name: python -c "from mimesis import Person; from mimesis.locales import Locale; print(Person(Locale.EN).full_name())"
Where can I get mimesis?
The source code and installation instructions are on GitHub: https://github.com/lk-geimfari/mimesis

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects