Skip to main content

​
pidgeon flock connect

Connect to a database and analyze its schema. 
pidgeon flock connect --provider <type> --connection-string <str>
FlagTypeDescription
--provider <type>stringDatabase type: postgres, mysql, sqlserver
--connection-string <str>stringDatabase connection string
pidgeon flock connect \
  --provider postgres \
  --connection-string "Host=localhost;Port=5432;Database=ehr;Username=dev;Password=secret"

​
pidgeon flock learn

Learn statistical patterns from existing sample data. 
pidgeon flock learn [options]
FlagTypeDefaultDescription
--tables <list>stringAll tablesComma-separated list of tables to analyze
--sample-size <n>int100Number of rows to sample per table
pidgeon flock learn --tables patients,encounters,diagnoses --sample-size 500

​
pidgeon flock generate

Generate a synthetic patient population. 
pidgeon flock generate [options]
FlagTypeDefaultDescription
--count <n>int100Number of patients to generate
--format <fmt>stringsqlOutput format: sql, csv, hl7, fhir
--geographic-focus <region>stringusGeographic distribution
--seed <n>intRandomReproducible seed
--output <path>stringstdoutOutput file or directory
# Generate 1000 patients as SQL
pidgeon flock generate --count 1000 --format sql --output ./seed-data/

# Generate as FHIR bundles
pidgeon flock generate --count 500 --format fhir --output ./fhir-data/

# Reproducible output
pidgeon flock generate --count 1000 --format csv --seed 42

​
pidgeon flock seed

Seed a connected database with generated data. 
pidgeon flock seed [options]
FlagTypeDescription
--dry-runflagPreview SQL without executing
--cleanupflagRemove previously seeded synthetic data
# Preview what would be inserted
pidgeon flock seed --dry-run

# Seed the database
pidgeon flock seed

# Clean up synthetic data
pidgeon flock seed --cleanup

​
pidgeon flock status

Check the status of a running generation job. 
pidgeon flock status