Skip to main content

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)

Source distribution for synthforge 0.1.0
File Size Uploaded Provenance
synthforge-0.1.0.tar.gz 58.4 kB Without provenance Details

Built distribution (wheel)

Table of built distributions (wheels) for synthforge 0.1.0
File Interpreter ABI Platform
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.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

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