> ## Documentation Index
> Fetch the complete documentation index at: https://docs.bioptimus.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Welcome

> Deploy and build with foundation models for biology — across histology, transcriptomics, and genomics.

Bioptimus builds foundation models that learn the dynamics of human biology across scales — from cell to tissue to organ. This documentation covers how to access, deploy, and build with our models on AWS and on-premise.

## How it works

Bioptimus models are pretrained on large, diverse histology data, so their representations transfer to many tasks without training from scratch. Point the SDK at a slide and a model, and it tiles the slide, masks out background, runs the model, and writes results to disk. For precise definitions, see the [Glossary](/documentation/resources/glossary).

<Tabs>
  <Tab title="1. Whole slide image">
    A scanned H\&E slide can be **billions of pixels** — too large to process at once — so the pipeline starts from the slide and splits it into small tiles, each processed independently.

    <Frame caption="H&E whole-slide image (TCGA-LUAD TCGA-75-7027). Representative example.">
      <img src="https://mintcdn.com/bioptimus-79a2297b/v6DGwj65gtzYzRw4/images/figures/wsi-thumbnail-luad.png?fit=max&auto=format&n=v6DGwj65gtzYzRw4&q=85&s=e32139d35e36cdf9e0993e686299ffa4" alt="H&E whole-slide image thumbnail" width="523" height="590" data-path="images/figures/wsi-thumbnail-luad.png" />
    </Frame>
  </Tab>

  <Tab title="2. Tissue segmentation">
    Slides are mostly background. The pipeline tiles coarsely (512×512 at 8 µm/px) and runs [tissue segmentation](/documentation/models/tissue-segmentation) to produce a tissue map, keeping only tissue-bearing tiles — cutting cost before the expensive feature step.

    <Frame caption="Tissue mask (right) beside the slide thumbnail (left), TCGA-LUAD TCGA-75-7027. Background is discarded before feature extraction. Representative example.">
      <img src="https://mintcdn.com/bioptimus-79a2297b/wzVDcCnzT959rZil/images/figures/tissue-mask-overlay.png?fit=max&auto=format&n=wzVDcCnzT959rZil&q=85&s=87a8dc92ffd6911fc6305d1d59b3b2fa" alt="Slide thumbnail alongside its binary tissue mask" width="1028" height="480" data-path="images/figures/tissue-mask-overlay.png" />
    </Frame>
  </Tab>

  <Tab title="3. Tile embeddings">
    Tissue tiles (224×224 at 0.5 µm/px) are embedded by [H-Optimus](/documentation/models/h-optimus) into a **1536-d feature vector** each. Principal components of these embeddings reveal the dominant axes of morphology — tumor, stroma, and immune compartments.

    <Frame caption="Principal components of tile embeddings mapped back onto the slide (TCGA-LUAD TCGA-75-7027) — PC1–PC3 each isolate a distinct tissue region. Representative example.">
      <img src="https://mintcdn.com/bioptimus-79a2297b/wzVDcCnzT959rZil/images/figures/embeddings-pca-spatial.png?fit=max&auto=format&n=wzVDcCnzT959rZil&q=85&s=b025c90df2d995becf9aa8c78f139f38" alt="Spatial heatmaps of the first three principal components of tile embeddings" width="1781" height="504" data-path="images/figures/embeddings-pca-spatial.png" />
    </Frame>
  </Tab>

  <Tab title="4. Spatial gene expression">
    [M-Optimus](/documentation/models/m-optimus) produces the same 1536-d embeddings **and** predicts spatial gene expression directly from each tile (optionally informed by bulk RNA) — a molecular readout without a spatial assay.

    <Frame caption="Spatial expression for a six-gene panel predicted from H&E (M-Optimus, TCGA-LUAD TCGA-75-7027). Representative example.">
      <img src="https://mintcdn.com/bioptimus-79a2297b/wzVDcCnzT959rZil/images/figures/gene-panel-overlay-bulk.png?fit=max&auto=format&n=wzVDcCnzT959rZil&q=85&s=5d1d3503a8ec780b4741ea1ce2fcd500" alt="Spatial gene-expression panel predicted from H&E by M-Optimus" width="1659" height="990" data-path="images/figures/gene-panel-overlay-bulk.png" />
    </Frame>
  </Tab>
</Tabs>

## The models

<CardGroup cols={2}>
  <Card title="H-Optimus" href="/documentation/models/h-optimus">
    A vision foundation model for histology. Extracts tile-level features from H\&E whole slide images.
  </Card>

  <Card title="M-Optimus" href="/documentation/models/m-optimus">
    A multimodal, multi-scale model (M-Optimus-1) that predicts spatial gene expression from routine H\&E, refined with bulk RNA.
  </Card>
</CardGroup>

Both models are trained on data from STELA, our data engine:

<Card title="STELA — data engine" icon="database" href="https://www.bioptimus.com/stela">
  A multi-institutional data engine generating the deeply profiled, clinically linked patient data our models train on.
</Card>

## Where to get each model

A quick map of which model is available on which channel, and where to start.

| Model                   | AWS & SageMaker                                 | On-premise                                   | Hugging Face                                     |
| ----------------------- | ----------------------------------------------- | -------------------------------------------- | ------------------------------------------------ |
| **H-Optimus**           | ✅ [Deploy](/deployment/platforms/aws-sagemaker) | ✅ [Deploy](/deployment/platforms/on-premise) | ✅ [Academic](/deployment/platforms/hugging-face) |
| **M-Optimus**           | ✅ [Deploy](/deployment/platforms/aws-sagemaker) | ✅ [Deploy](/deployment/platforms/on-premise) | —                                                |
| **Tissue segmentation** | ✅ (bundled)                                     | ✅ (bundled)                                  | —                                                |

<CardGroup cols={3}>
  <Card title="AWS & SageMaker" href="/deployment/platforms/aws-sagemaker">
    Managed endpoints from AWS Marketplace.
  </Card>

  <Card title="On-premise" href="/deployment/platforms/on-premise">
    Self-hosted container for full data control.
  </Card>

  <Card title="Hugging Face" href="/deployment/platforms/hugging-face">
    H-Optimus weights for non-commercial academic use.
  </Card>
</CardGroup>

## Where to start

<CardGroup cols={3}>
  <Card title="Run your first inference" href="/documentation/quickstart">
    Deploy a model and get embeddings back in minutes. For ML engineers and data scientists.
  </Card>

  <Card title="Explore use cases" href="/documentation/use-cases/biomarker-discovery">
    See how teams use our models for biomarker discovery, indication expansion, and trial design.
  </Card>

  <Card title="Security & compliance" href="/documentation/resources/security-compliance">
    Data handling, residency, and deployment options for regulated environments.
  </Card>
</CardGroup>

<Warning>
  Bioptimus models are for **research use** and are not approved medical devices. See [Responsible use](/documentation/resources/responsible-use) for intended use and your responsibilities.
</Warning>
