Skip to content

AugMed Platform Documentation

What is AugMed?

AugMed is a clinical case review platform for research on AI-augmented medical decision-making. It presents clinicians with de-identified patient cases drawn from electronic health record data (structured in the OMOP Common Data Model) and collects their diagnostic assessments, risk ratings, and clinical recommendations.

Each participant sees a carefully controlled subset of clinical information — determined by the researcher's experimental design — which may or may not include AI-generated predictions. This controlled information disclosure is the core experimental mechanism: by varying which features each participant sees, researchers can measure how AI assistance, clinical history details, and other factors influence clinical judgment.

AugMed is domain-agnostic: any clinical scenario that can be represented in OMOP CDM format can be studied on the platform. See Adapting AugMed for Your Study for how to configure the platform for your clinical domain.

Who This Documentation Is For

This documentation is written for:

  • Researchers who want to design and run experiments using the platform, export data, and analyze results. No programming background is assumed for the researcher-facing guides.
  • Administrators who manage deployment, database configuration, and system maintenance.
  • Developers who need to understand the API, database schema, or extend the platform.

Deploy

Getting Started

Researcher Guide

Admin Guide

  • Deployment — AWS infrastructure, CI/CD, environment variables
  • Database — Schema overview, key tables, relationships
  • Configuration — System config, answer configs, display config format
  • Troubleshooting — Common issues, logs, health checks

Adaptive Experiments (RL)

Reference

Guides

Examples

  • CRC Screening Study — Complete worked example from the AIM-AHEAD colorectal cancer screening study

Live Site

The production instance of AugMed is available at: https://augmed1.dhep.org/

Repositories

  • Backend API (this repository): Flask + PostgreSQL
  • Frontend: augmed-app-v2 (React + TypeScript)
  • RL Service: augmed-rl (FastAPI, Thompson Sampling)
  • Infrastructure: augmed-infra (Terraform, AWS)