SynthForge
Next-generation synthetic data generation with LLM-augmented pipelines.
SynthForge combines statistical generative models (Gaussian Copula, CTGAN, TVAE, Diffusion) with LLM-powered intelligence (schema enrichment, PII/MNPI detection, semantic validation) to produce high-fidelity synthetic tabular data from small production samples.
Quick Start
import pandas as pd
from synthforge import SynthForge
# Load a sample from production (e.g., 2500 rows from Redshift)
df = pd.read_csv("production_sample.csv")
# One-line generation
forge = SynthForge()
synthetic_df = forge.fit_generate(df, num_rows=100_000)
# With LLM enrichment (auto-detects PII, infers semantics)
forge = SynthForge(llm_provider="anthropic", llm_model="claude-sonnet-4-20250514")
forge.profile(df) # Schema enrichment + PII detection
forge.fit(df) # Train synthesizer
synthetic_df = forge.generate(100_000) # Bulk generate
report = forge.evaluate(df, synthetic_df) # Quality report
Key Features
- Intelligent Schema Detection: LLM-powered column semantic inference beyond statistical type detection
- PII/MNPI Detection: Presidio + LLM augmentation for catching non-obvious sensitive data
- Multiple Synthesizers: Gaussian Copula (fast), CTGAN/TVAE (balanced), TabSyn (highest quality)
- Data-Type Strategies: Specialized pipelines for categorical, numerical, time-series, and mixed-type tables
- Evaluation-First: Built-in quality reports with statistical fidelity, ML utility, and privacy metrics
- Configurable Scale: From 1K to 10M+ rows with batch generation and optional GPU acceleration
- LLM-Agnostic: Works with Claude, OpenAI, Ollama, vLLM, or any LiteLLM-supported provider
Installation
pip install synthforge # Core (Gaussian Copula only)
pip install "synthforge[gan]" # + CTGAN/TVAE
pip install "synthforge[llm]" # + LLM enrichment
pip install "synthforge[evaluation]" # + quality reports
pip install "synthforge[all]" # Everything
Architecture
Production Sample (DataFrame/CSV)
│
▼
┌─────────────────────────────────┐
│ 1. PROFILE (LLM-augmented) │
│ • Auto-detect metadata │
│ • Semantic column inference │
│ • PII / MNPI detection │
│ • Business rule extraction │
│ • Synthesizer recommendation │
└─────────────┬───────────────────┘
▼
┌─────────────────────────────────┐
│ 2. FIT (Statistical/Neural) │
│ • Reversible data transforms │
│ • Constraint-aware training │
│ • Auto-select or user-pick: │
│ GaussianCopula / CTGAN / │
│ TVAE / TabSyn / Diffusion │
└─────────────┬───────────────────┘
▼
┌─────────────────────────────────┐
│ 3. GENERATE (Batch) │
│ • Configurable row count │
│ • Batch chunking for scale │
│ • Constraint enforcement │
│ • PII replacement (Faker) │
└─────────────┬───────────────────┘
▼
┌─────────────────────────────────┐
│ 4. EVALUATE (5-layer pipeline) │
│ • Diagnostic checks │
│ • Statistical fidelity │
│ • ML utility (TSTR) │
│ • Privacy (MIA, Anonymeter) │
│ • LLM semantic validation │
└─────────────────────────────────┘
License
Proprietary. All rights reserved.
Metadata
Release files for synthforge 0.1.0
For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.
Source distribution (sdist)
| File | Size | Uploaded | Provenance | |
|---|---|---|---|---|
| synthforge-0.1.0.tar.gz | 58.4 kB | Without provenance | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| synthforge-0.1.0-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 117.4 kB
Release files / synthforge-0.1.0.tar.gz
| Download URL | synthforge-0.1.0.tar.gz |
|---|---|
| Size | 58.4 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
d32bc7968155ca2b3ffcc354d42b602837b7b0af831916c08ba28c2008a8b83c
|
|
BLAKE2b-256 checksum How to use checksums |
1fbcf2276c4776400c308f2e8e4c51506fbcdd89bb8c4bcfea33051e58232a11
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Release files / synthforge-0.1.0-py3-none-any.whl
| Download URL | synthforge-0.1.0-py3-none-any.whl |
|---|---|
| Size | 59.1 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
832cab7229bd20479b62f92fe1a4b1b428e694b5114b44c94dfae809bff6e41f
|
|
BLAKE2b-256 checksum How to use checksums |
f1819c459ce3e1bf72ca41a683204573c709e110d4cfcea02de0ae3b52c96f2f
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
No |
| Uploaded via |
twine/6.2.0 CPython/3.12.12
|
Security for synthforge 0.1.0
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.
No provenance found
None of the files in this release were uploaded with provenance metadata.
A note on package security
PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.
To learn more about protecting yourself from malicious actors, visit our package security documentation.