Skip to content

OMOP Alchemy

OMOP Alchemy provides a canonical, typed, SQLAlchemy-first representation of the OHDSI OMOP Common Data Model (CDM).

It is designed for research-ready analytics, validation, and exploration.

Where OMOP Alchemy fits

OMOP Alchemy sits between raw OMOP databases and exploratory analytics, validation, and research tooling

It provides:

  • stable ORM models
  • explicit relationships
  • safe, inspectable abstractions

without imposing workflow assumptions.


What’s in this documentation

Getting started

How to install OMOP Alchemy, create sessions, and start querying safely.


OMOP CDM models

Typed ORM models corresponding to the official OMOP CDM tables, organised by clinical and operational domain.


Validation & semantics

Object- and model-level validation utilities that help maintain semantic clarity during analysis.


Advanced usage

Patterns and techniques for more complex analytical work.


API reference

Low-level primitives and decorators used throughout the library.

Example

from omop_alchemy.cdm.model.vocabulary import ConceptView

concept = session.get(ConceptView, 320128)
concept.domain.domain_id
concept.vocabulary.vocabulary_id
concept.is_standard

Status

OMOP Alchemy is currently beta. The core model surface is stabilising; feedback is welcome.