# Quick start

Get your first synthetic record in under two minutes.

## Step 1: Install the CLI

macOS and Linux:

```bash
curl -fsSL https://simdata.interoperabilitypro.com/install.sh | sh
simhealth login
simhealth projects use default
simhealth sample person --count 1 --seed 1842
```

Windows (PowerShell):

```powershell
irm https://simdata.interoperabilitypro.com/install.ps1 | iex
simhealth login
simhealth projects use default
simhealth sample person --count 1 --seed 1842
```

`simhealth login` opens a browser (or prints a device code with `--no-browser`).
If you have not created an account, [sign up](https://simdata.interoperabilitypro.com/signup)
during that flow.

## Step 2: Choose a project

`simhealth projects use default` selects the default dictionary. Create another
workspace with `simhealth projects create NAME`, then `simhealth projects use ID`.
Edit that project's lists and records on the website at
`/projects/{project_id}/dictionary`.

## Step 3: Test reproducibility

Run the same `simhealth sample` command again. Because the seed is identical, the
generated record is identical. Change the seed to deterministically draw a
different record.

```bash
simhealth sample person --count 1 --seed 1842
```

## Step 4: Stream more records

JSON is the default (`--format json`). Use NDJSON or Avro for bulk jobs:

```bash
simhealth sample person --count 10000 --seed 1842 --format avro > persons.avro
```

HTTP clients that already have a project-bound API key can call the same
sampler at `GET https://api.simdata.interoperabilitypro.com/v1/projects/{project_id}/random/{recordType}`.
See [Generate records](api/random.md).
