Skip to main content
Pre-release

This release is a pre-release and may not be stable for production use.

seedfaker

Python binding for seedfaker — deterministic synthetic data with 200+ fields, 68 locales, same seed = same output.

CLI · Node.js · Python · Browser/WASM · Go · PHP · Ruby · MCP

pip install seedfaker

Pre-1.0 notice: The API may change between minor versions until 1.0.0 is released. Pin your version and check CHANGELOG.md before upgrading.

Python API

from seedfaker import SeedFaker

f = SeedFaker(seed="ci", locale="en")

# Single values
f.field("name")
f.field("phone", e164=True)
f.field("credit-card", space=True)
f.field("email", omit=30)                    # "" for 30% of calls

# Weighted locales: 70% English, 20% German, 10% French
mixed = SeedFaker(seed="ci", locale="en=7,de=2,fr=1")

# Single correlated record
f.record(["name", "email", "phone"], ctx="strict")
# → {"name": "Zoe Kumar", "email": "zoe.kumar@...", "phone": "+1..."}

# Batch
f.records(["name", "email", "phone"], n=5, ctx="strict")

# Validate without generating
f.validate(["name", "email:e164"])  # raises ValueError if invalid

# Corruption
f.records(["name", "email", "ssn"], n=100, corrupt="high")

# Determinism — same seed = same output
a = SeedFaker(seed="test")
b = SeedFaker(seed="test")
assert a.field("name") == b.field("name")

# Fingerprint — detect algorithm changes after upgrade
SeedFaker.fingerprint()  # 'sf0-...'

# All field names
SeedFaker.fields()

Documentation


Disclaimer

This software generates synthetic data that may resemble real-world identifiers, credentials, or personal information. All output is artificial. See LICENSE for the full legal disclaimer.

Metadata

Release files for seedfaker 0.4.0a1

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Built distributions (wheels)

Table of built distributions (wheels) for seedfaker 0.4.0a1
File
seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_x86_64.whl CPython 3.8 abi3 Linux glibc 2.34+ x86-64 Details
seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_aarch64.whl CPython 3.8 abi3 Linux glibc 2.34+ ARM64 Details
seedfaker-0.4.0a1-cp38-abi3-macosx_11_0_arm64.whl CPython 3.8 abi3 macOS 11.0+ ARM64 Details
seedfaker-0.4.0a1-cp38-abi3-macosx_10_12_x86_64.whl CPython 3.8 abi3 macOS 10.12+ x86-64 Details

Total release size: 3.6 MB

Release files / seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_x86_64.whl

Download URL seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_x86_64.whl
Size 1.0 MB
Tags CPython 3.8 Linux glibc 2.34+ x86-64 abi3
SHA-256 checksum
How to use checksums
2b66673fe7957c8e7d7937d84ae425a190e21abba07c5687de7a24d80a590226
BLAKE2b-256 checksum
How to use checksums
b04651c59300ece882148240145a76e517491466f7fc73b7f880ed179a1a0041
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 3, 2026.

Transparency log

Release files / seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_aarch64.whl

Download URL seedfaker-0.4.0a1-cp38-abi3-manylinux_2_34_aarch64.whl
Size 996.7 kB
Tags CPython 3.8 Linux glibc 2.34+ ARM64 abi3
SHA-256 checksum
How to use checksums
70c523b900f08d72203a660ba8b3cf604f1734b49765d073415eab0158b9773d
BLAKE2b-256 checksum
How to use checksums
b385cc93bcf43215b17907454fb756f7938a6cac2769619977f2128c5308bb81
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 3, 2026.

Transparency log

Release files / seedfaker-0.4.0a1-cp38-abi3-macosx_11_0_arm64.whl

Download URL seedfaker-0.4.0a1-cp38-abi3-macosx_11_0_arm64.whl
Size 773.0 kB
Tags CPython 3.8 abi3 macOS 11.0+ ARM64
SHA-256 checksum
How to use checksums
457fa1c6ebf2f0e309c3c0d08bff96a9c671d001f642b4452bc2d615af521420
BLAKE2b-256 checksum
How to use checksums
6fa00d3f54110964a4be8783e5ba7dfb57a82dc1ce38784e5b52519497c0fc2b
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 3, 2026.

Transparency log

Release files / seedfaker-0.4.0a1-cp38-abi3-macosx_10_12_x86_64.whl

Download URL seedfaker-0.4.0a1-cp38-abi3-macosx_10_12_x86_64.whl
Size 774.4 kB
Tags CPython 3.8 abi3 macOS 10.12+ x86-64
SHA-256 checksum
How to use checksums
cf32fd9445f7f0c0062a849b1196952c91acd9d4754018e53b55f67b15a708c3
BLAKE2b-256 checksum
How to use checksums
1c6b1c0ed6eb48d059eaaa25072f1644edf2f9e05fb6760bf358817c34f4be0a
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

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 May 3, 2026.

Transparency log
Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page