Skip to content

Home

Jump to bottom
Roberto Cruz edited this page May 15, 2026 · 3 revisions

TietAI Synthea — Python Synthetic Patient Generator

Synthea is TietAI's Python implementation of Synthea™, a Synthetic Patient Population Simulator that generates realistic (but not real) patient data and associated health records in FHIR R4, CSV, and JSON formats.

Quick Navigation

Topic Description
Getting Started Installation, prerequisites, and your first patients
Configuration All configuration options and synthea.properties
Command Line Interface Full CLI reference with examples
Python API Using Synthea programmatically in your code
Disease Modules The 231 included modules and how to write custom ones
Export Formats FHIR R4, CSV, and JSON output formats
Performance & Scaling Multi-threading, memory optimization, and benchmarks
Testing Running tests and writing new ones
Contributing How to contribute to Synthea
Architecture Internal design and component overview
Troubleshooting Common issues and solutions

What Is Synthea?

Synthea simulates complete patient lifecycles — from birth to death — applying clinically realistic disease progression, medications, immunizations, and encounters. It is designed for:

  • Healthcare AI development — train and test ML models without real patient data
  • FHIR integration testing — validate pipelines against realistic R4 bundles
  • EHR demo environments — populate systems with believable records
  • Research and education — generate population cohorts for analysis

Key Features

  • 231 disease modules — diabetes, heart disease, COVID-19, cancer, mental health, and more
  • FHIR R4 output — standards-compliant bundles ready for any FHIR server
  • Realistic demographics — based on US Census data with geographic distributions
  • Full healthcare ecosystem — providers, payers, cost modeling, and insurance
  • Fast dependency management — powered by UV
  • Python API — integrate generation into your own pipelines

Repository

Synthea is a Python port of the original Synthea project by The MITRE Corporation, extended and maintained by TietAI.

Clone this wiki locally