DocumentationSynthesize Safe Data

Tutorials

View as Markdown

Learn how to run NeMo Safe Synthesizer jobs through hands-on tutorials to generate private synthetic versions of sensitive tabular datasets. Each tutorial provides step-by-step guidance with executable code examples.

Prerequisites

Before starting any tutorial, ensure you have:

  • NeMo Safe Synthesizer running
  • Python environment with the PyPI nemo-platform wrapper package installed. The all extra is defined by the wrapper package, not by the generated SDK package under sdk/python/nemo-platform/pyproject.toml. If you are working from a source checkout, run make bootstrap from the repository root instead.
$pip install "nemo-platform[all]"
  • Jupyter environment for running tutorial notebooks

Getting Started

Safe Synthesizer 101

Learn the basics with your first Safe Synthesizer job, leveraging smart defaults. This tutorial covers uploading data, running a synthesis job with PII replacement, and reviewing evaluation reports.

Topics covered:

  • Installing the SDK
  • Connecting to Safe Synthesizer
  • Using SafeSynthesizerJobBuilder
  • Monitoring job progress
  • Retrieving synthetic data and evaluation reports
beginner 20 minutes

Advanced Topics

Differential Privacy Tutorial

Apply differential privacy to achieve the maximum level of privacy with mathematical guarantees. This tutorial explores the privacy-utility tradeoff and how to configure differential privacy parameters.

Topics covered:

  • Understanding differential privacy concepts (epsilon, delta)
  • Configuring privacy hyperparameters
  • Privacy budget analysis
  • Evaluating privacy-utility tradeoffs
  • Interpreting privacy metrics
intermediate 1.5 hours

Additional Resources

After completing these tutorials, explore:

  • index: Understand core concepts and components

Need Help?