Overview
CTGAN is a collection of Deep Learning based synthetic data generators for single table data, which are able to learn from real data and generate synthetic data with high fidelity.
| Important Links | |
|---|---|
| :computer: Website | Check out the SDV Website for more information about our overall synthetic data ecosystem. |
| :orange_book: Blog | A deeper look at open source, synthetic data creation and evaluation. |
| :book: Documentation | Quickstarts, User and Development Guides, and API Reference. |
| :octocat: Repository | The link to the Github Repository of this library. |
| :keyboard: Development Status | This software is in its Pre-Alpha stage. |
| :busts_in_silhouette: DataCebo Forum | Discuss CTGAN features, ask questions, and receive help. |
Currently, this library implements the CTGAN and TVAE models described in the Modeling Tabular data using Conditional GAN paper, presented at the 2019 NeurIPS conference.
Install
Use CTGAN through the SDV library
:warning: If you're just getting started with synthetic data, we recommend installing the SDV library which provides user-friendly APIs for accessing CTGAN. :warning:
The SDV library provides wrappers for preprocessing your data as well as additional usability features like constraints. See the SDV documentation to get started.
Use the CTGAN standalone library
Alternatively, you can also install and use CTGAN directly, as a standalone library:
Using pip:
pip install ctgan
Using conda:
conda install -c pytorch -c conda-forge ctgan
When using the CTGAN library directly, you may need to manually preprocess your data into the correct format, for example:
- Continuous data must be represented as floats
- Discrete data must be represented as ints or strings
- The data should not contain any missing values
Usage Example
In this example we load the Adult Census Dataset* which is a built-in demo dataset. We use CTGAN to learn from the real data and then generate some synthetic data.
from ctgan import CTGAN
from ctgan import load_demo
real_data = load_demo()
# Names of the columns that are discrete
discrete_columns = [
'workclass',
'education',
'marital-status',
'occupation',
'relationship',
'race',
'sex',
'native-country',
'income'
]
ctgan = CTGAN(epochs=10)
ctgan.fit(real_data, discrete_columns)
# Create synthetic data
synthetic_data = ctgan.sample(1000)
*For more information about the dataset see: Dua, D. and Graff, C. (2019). UCI Machine Learning Repository [http://archive.ics.uci.edu/ml]. Irvine, CA: University of California, School of Information and Computer Science.
Join our community
Join our forum to discuss more about CTGAN, ask questions, and receive help.
Interested in contributing to CTGAN? Read our Contribution Guide to get started.
Citing CTGAN
If you use CTGAN, please cite the following work:
Lei Xu, Maria Skoularidou, Alfredo Cuesta-Infante, Kalyan Veeramachaneni. Modeling Tabular data using Conditional GAN. NeurIPS, 2019.
@inproceedings{ctgan,
title={Modeling Tabular data using Conditional GAN},
author={Xu, Lei and Skoularidou, Maria and Cuesta-Infante, Alfredo and Veeramachaneni, Kalyan},
booktitle={Advances in Neural Information Processing Systems},
year={2019}
}
Related Projects
Please note that these projects are external to the SDV Ecosystem. They are not affiliated with or maintained by DataCebo.
- R Interface for CTGAN: A wrapper around CTGAN that brings the functionalities to R users. More details can be found in the corresponding repository: https://github.com/kasaai/ctgan
- CTGAN Server CLI: A package to easily deploy CTGAN onto a remote server. Created by Timothy Pillow @oregonpillow at: https://github.com/oregonpillow/ctgan-server-cli
The Synthetic Data Vault Project was first created at MIT's Data to AI Lab in 2016. After 4 years of research and traction with enterprise, we created DataCebo in 2020 with the goal of growing the project. Today, DataCebo is the proud developer of SDV, the largest ecosystem for synthetic data generation & evaluation. It is home to multiple libraries that support synthetic data, including:
- 🔄 Data discovery & transformation. Reverse the transforms to reproduce realistic data.
- 🧠 Multiple machine learning models -- ranging from Copulas to Deep Learning -- to create tabular, multi table and time series data.
- 📊 Measuring quality and privacy of synthetic data, and comparing different synthetic data generation models.
Get started using the SDV package -- a fully integrated solution and your one-stop shop for synthetic data. Or, use the standalone libraries for specific needs.
8 maintainers
Metadata
8 maintainers
Release files for ctgan 0.12.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 | |
|---|---|---|---|
| ctgan-0.12.1.tar.gz | 27.1 kB | Details |
Built distribution (wheel)
| File | Interpreter | ABI | Platform | Reset |
|---|---|---|---|---|
| ctgan-0.12.1-py3-none-any.whl | Python 3 | none | any | Details |
Total release size: 52.6 kB
Release files / ctgan-0.12.1.tar.gz
| Download URL | ctgan-0.12.1.tar.gz |
|---|---|
| Size | 27.1 kB |
| Tags | Source |
|
SHA-256 checksum How to use checksums |
e545c2b1a752affba3de2933a5f8037228e837f7a73f5593399b52cfe9611bc7
|
|
BLAKE2b-256 checksum How to use checksums |
f40e50724b2e49ad83c2ebd00d8b57753dc07f256b27e64aca1306de5f4666b8
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 13, 2026.
Transparency logRelease files / ctgan-0.12.1-py3-none-any.whl
| Download URL | ctgan-0.12.1-py3-none-any.whl |
|---|---|
| Size | 25.5 kB |
| Tags | Python 3 |
|
SHA-256 checksum How to use checksums |
38a3b83432643caa8381c74c49e6a079166efa40f8f6c3b7204db44d6d2c8f18
|
|
BLAKE2b-256 checksum How to use checksums |
a7c2e4761d20a9704ba7595ea7d14dc4880c3cd0bd81b8ae588435536b7d8f19
|
| Upload date | |
|
Uploaded using Trusted Publishing? What is trusted publishing? |
Yes |
| Uploaded via |
twine/6.1.0 CPython/3.13.7
|
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 Feb 13, 2026.
Transparency log
