Verisim
Context-aware synthetic data for Python. The name comes from “verisimilitude,” meaning “the appearance of being real.”
Verisim generates coherent Pydantic domain objects with shared context. A person's name, username, email, address, job, company, and bio fit together, making the data useful for demos, seed data, tests, and synthetic datasets. Generation runs offline by default, supports reproducible seeds, and uses non-routable synthetic contact details.
Status: early prototype (alpha). See the feature guides below for usage and current limits.
Install
Requires Python 3.11 or newer.
uv add verisim
# Or:
python -m pip install verisim
Quickstart
from verisim import PersonRecord, Verisim
record = Verisim(locale="en_US", seed=123).generate(PersonRecord)
print(record.person.name)
print(record.contact.email)
print(record.model_dump_json())
verisim person-record --seed 123
Feature Guides
| Feature | README |
|---|---|
| Core models, context, related datasets, schema inference, statistical profiles, QA modes, CLI, and activity streams | Core generation |
| JSON/JSONL, CSV, SQL, SQLite, Parquet, Arrow, Avro, and schema contracts | Exports |
| Locale, script, lite/full data packs, and data provenance | Data packs |
| Coherent replacements for existing tabular PII | Masking |
| SQLAlchemy, Django, and pytest factories and fixtures | Framework integrations |
| Offline instruction pairs, classification, NER, chat datasets, and custom adapters | AI training |
| Measured API branch scenarios and replayable fixture bundles | API fixtures |
| Runnable examples and a comparison with independent random fields | Examples |
Contributing
See CONTRIBUTING.md for source setup and local checks, CHANGELOG.md for changes, and RELEASING.md for release instructions.
License
MIT.
1 maintainer
Metadata
1 maintainer
Release files for verisim 0.2.1
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | |
|---|---|---|---|
| verisim-0.2.1.tar.gz | 14.8 MB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| verisim-0.2.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 29.9 MB
Release files / verisim-0.2.1.tar.gz
| Download URL | verisim-0.2.1.tar.gz |
|---|---|
| Size | 14.8 MB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
bf0820c50966daf4169fb1cbf2dab0b13af7ea8caf754b5790fa5c49e6d911c2
|
|
BLAKE2b-256 checksum How to use checksums |
c49e3d7e7c861d6c7fd945402d6d6a703ba480f595d5303c2e7419a10dda0d89
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency logRelease files / verisim-0.2.1-py3-none-any.whl
| Download URL | verisim-0.2.1-py3-none-any.whl |
|---|---|
| Size | 15.1 MB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
f9f70cabb64865927b7098b78e96feec3e3424da7fcae7d2fbbe28ea7432f937
|
|
BLAKE2b-256 checksum How to use checksums |
beafc18207be1de589e92fbfbdaa0cbad4b14366d3f4831aa331027e9277d34a
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/7.0.0 CPython/3.13.14
|
Provenance
Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.
PyPI Publish Attestation
PyPI verified that this artifact, at this checksum, originated from the publisher listed below.
Signed by GitHub Actions, verified by PyPI on Oct 7, 2026.
Transparency log
