Skip to content

Quick Start

Get Aether running in 5 minutes.

1. Create Configuration

Create a file named aether.yaml in your working directory:

yaml
services:
  torch:
    base_url: "https://your-torch-server.org"
    username: "your-username"
    password: "your-password"

  dimp:
    url: "http://your-dimp-server:32861/fhir"

pipeline:
  enabled_steps:
    - torch
    - dimp

jobs_dir: "./jobs"

Replace the URLs and credentials with your actual server details.

2. Run a Pipeline

bash
aether pipeline start your-query.crtdl

Aether will:

  1. Send your CRTDL query to TORCH
  2. Wait for extraction to complete
  3. Download the FHIR data
  4. Pseudonymize it via DIMP
  5. Save results in the jobs folder

3. Check Progress

bash
# List all jobs
aether job list

# Check a specific job
aether pipeline status <job-id>

4. Resume if Needed

If a pipeline fails, resume it:

bash
aether pipeline continue <job-id>

Next Steps

Healthcare data integration made simple