From 695838432747b9c9460e74cd3f5086642b6897a9 Mon Sep 17 00:00:00 2001
From: Ogundepo Odunayo <ogundepoodunayo@gmail.com>
Date: Thu, 9 Nov 2023 12:49:17 -0500
Subject: [PATCH] Add support for TrOCR Model (#1303)

* add bce with logit loss

* add bce with logit loss

* remove imports

* fix tiny bug

* add test documentation and refactor function

* fix test cases and formatting

* add trocr model

* fix formatting

* commit the actual model lol

* more formatting

* remove tokenizer config
---
 .../examples/trocr/assets/trocr.png           | Bin 0 -> 36733 bytes
 .../examples/trocr/image_processor.rs         | 154 +++++++
 candle-examples/examples/trocr/main.rs        | 132 ++++++
 candle-examples/examples/trocr/readme.md      |  16 +
 candle-transformers/src/models/mod.rs         |   1 +
 candle-transformers/src/models/trocr.rs       | 434 ++++++++++++++++++
 candle-transformers/src/models/vit.rs         |  45 +-
 7 files changed, 767 insertions(+), 15 deletions(-)
 create mode 100644 candle-examples/examples/trocr/assets/trocr.png
 create mode 100644 candle-examples/examples/trocr/image_processor.rs
 create mode 100644 candle-examples/examples/trocr/main.rs
 create mode 100644 candle-examples/examples/trocr/readme.md
 create mode 100644 candle-transformers/src/models/trocr.rs

diff --git a/candle-examples/examples/trocr/assets/trocr.png b/candle-examples/examples/trocr/assets/trocr.png
new file mode 100644
index 0000000000000000000000000000000000000000..06886aab121616bdfc526adbae2e66e9f3becc50
GIT binary patch
literal 36733
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

literal 0
HcmV?d00001

diff --git a/candle-examples/examples/trocr/image_processor.rs b/candle-examples/examples/trocr/image_processor.rs
new file mode 100644
index 00000000..531caa56
--- /dev/null
+++ b/candle-examples/examples/trocr/image_processor.rs
@@ -0,0 +1,154 @@
+use image::{DynamicImage, ImageBuffer};
+use serde::Deserialize;
+use std::collections::HashMap;
+
+use candle::{DType, Device, Result, Tensor};
+
+#[derive(Debug, Clone, PartialEq, Deserialize)]
+pub struct ProcessorConfig {
+    do_resize: bool,
+    height: u32,
+    width: u32,
+    do_rescale: bool,
+    do_normalize: bool,
+    image_mean: Vec<f32>,
+    image_std: Vec<f32>,
+}
+
+impl Default for ProcessorConfig {
+    fn default() -> Self {
+        Self {
+            do_resize: true,
+            height: 384,
+            width: 384,
+            do_rescale: true,
+            do_normalize: true,
+            image_mean: vec![0.5, 0.5, 0.5],
+            image_std: vec![0.5, 0.5, 0.5],
+        }
+    }
+}
+
+pub struct ViTImageProcessor {
+    do_resize: bool,
+    height: u32,
+    width: u32,
+    do_normalize: bool,
+    image_mean: Vec<f32>,
+    image_std: Vec<f32>,
+}
+
+impl ViTImageProcessor {
+    pub fn new(config: &ProcessorConfig) -> Self {
+        Self {
+            do_resize: config.do_resize,
+            height: config.height,
+            width: config.width,
+            do_normalize: config.do_normalize,
+            image_mean: config.image_mean.clone(),
+            image_std: config.image_std.clone(),
+        }
+    }
+
+    pub fn preprocess(&self, images: Vec<&str>) -> Result<Tensor> {
+        let height = self.height as usize;
+        let width = self.width as usize;
+        let channels = 3;
+
+        let images = self.load_images(images)?;
+
+        let resized_images: Vec<DynamicImage> = if self.do_resize {
+            images
+                .iter()
+                .map(|image| self.resize(image.clone(), None).unwrap())
+                .collect()
+        } else {
+            images
+        };
+
+        let normalized_images: Vec<Tensor> = if self.do_normalize {
+            resized_images
+                .iter()
+                .map(|image| self.normalize(image.clone(), None, None).unwrap())
+                .collect()
+        } else {
+            let resized_images: Vec<ImageBuffer<image::Rgb<u8>, Vec<u8>>> =
+                resized_images.iter().map(|image| image.to_rgb8()).collect();
+            let data = resized_images
+                .into_iter()
+                .map(|image| image.into_raw())
+                .collect::<Vec<Vec<u8>>>();
+
+            data.iter()
+                .map(|image| {
+                    Tensor::from_vec(image.clone(), (height, width, channels), &Device::Cpu)
+                        .unwrap()
+                        .permute((2, 0, 1))
+                        .unwrap()
+                })
+                .collect::<Vec<Tensor>>()
+        };
+
+        Tensor::stack(&normalized_images, 0)
+    }
+
+    fn resize(
+        &self,
+        image: image::DynamicImage,
+        size: Option<HashMap<String, u32>>,
+    ) -> Result<image::DynamicImage> {
+        let (height, width) = match &size {
+            Some(size) => (size.get("height").unwrap(), size.get("width").unwrap()),
+            None => (&self.height, &self.width),
+        };
+
+        let resized_image =
+            image.resize_exact(*width, *height, image::imageops::FilterType::Triangle);
+
+        Ok(resized_image)
+    }
+
+    fn normalize(
+        &self,
+        image: image::DynamicImage,
+        mean: Option<Vec<f32>>,
+        std: Option<Vec<f32>>,
+    ) -> Result<Tensor> {
+        let mean = match mean {
+            Some(mean) => mean,
+            None => self.image_mean.clone(),
+        };
+
+        let std = match std {
+            Some(std) => std,
+            None => self.image_std.clone(),
+        };
+
+        let mean = Tensor::from_vec(mean, (3, 1, 1), &Device::Cpu)?;
+        let std = Tensor::from_vec(std, (3, 1, 1), &Device::Cpu)?;
+
+        let image = image.to_rgb8();
+        let data = image.into_raw();
+
+        let height = self.height as usize;
+        let width = self.width as usize;
+        let channels = 3;
+
+        let data =
+            Tensor::from_vec(data, &[height, width, channels], &Device::Cpu)?.permute((2, 0, 1))?;
+
+        (data.to_dtype(DType::F32)? / 255.)?
+            .broadcast_sub(&mean)?
+            .broadcast_div(&std)
+    }
+
+    pub fn load_images(&self, image_path: Vec<&str>) -> Result<Vec<image::DynamicImage>> {
+        let mut images: Vec<image::DynamicImage> = Vec::new();
+        for path in image_path {
+            let img = image::io::Reader::open(path)?.decode().unwrap();
+            images.push(img);
+        }
+
+        Ok(images)
+    }
+}
diff --git a/candle-examples/examples/trocr/main.rs b/candle-examples/examples/trocr/main.rs
new file mode 100644
index 00000000..e93d6b2f
--- /dev/null
+++ b/candle-examples/examples/trocr/main.rs
@@ -0,0 +1,132 @@
+#[cfg(feature = "mkl")]
+extern crate intel_mkl_src;
+
+#[cfg(feature = "accelerate")]
+extern crate accelerate_src;
+
+use anyhow::Error as E;
+use clap::{Parser, ValueEnum};
+
+use candle::{DType, Tensor};
+use candle_examples::token_output_stream::TokenOutputStream;
+use candle_nn::VarBuilder;
+use candle_transformers::models::trocr;
+
+use tokenizers::Tokenizer;
+mod image_processor;
+
+#[derive(Clone, Debug, Copy, ValueEnum)]
+enum Which {
+    Base,
+    Large,
+}
+
+#[derive(Parser, Debug)]
+struct Args {
+    #[arg(long)]
+    model: Option<String>,
+
+    /// Choose the variant of the model to run.
+    #[arg(long, default_value = "base")]
+    which: Which,
+
+    /// Run on CPU rather than on GPU.
+    #[arg(long)]
+    cpu: bool,
+
+    /// Text to be translated
+    #[arg(long)]
+    image: String,
+}
+
+pub fn main() -> anyhow::Result<()> {
+    use hf_hub::api::sync::Api;
+    let args = Args::parse();
+
+    let tokenizer_dec = {
+        let tokenizer = Api::new()?
+            .model(String::from("ToluClassics/candle-trocr-tokenizer"))
+            .get("tokenizer.json")?;
+
+        Tokenizer::from_file(&tokenizer).map_err(E::msg)?
+    };
+
+    let mut tokenizer_dec = TokenOutputStream::new(tokenizer_dec);
+
+    let device = candle_examples::device(args.cpu)?;
+
+    let vb = {
+        let model = match args.model {
+            Some(model) => std::path::PathBuf::from(model),
+            None => match args.which {
+                Which::Base => Api::new()?
+                    .repo(hf_hub::Repo::with_revision(
+                        "microsoft/trocr-base-handwritten".to_string(),
+                        hf_hub::RepoType::Model,
+                        "refs/pr/3".to_string(),
+                    ))
+                    .get("model.safetensors")?,
+                Which::Large => Api::new()?
+                    .repo(hf_hub::Repo::with_revision(
+                        "microsoft/trocr-large-handwritten".to_string(),
+                        hf_hub::RepoType::Model,
+                        "refs/pr/6".to_string(),
+                    ))
+                    .get("model.safetensors")?,
+            },
+        };
+        println!("model: {:?}", model);
+        unsafe { VarBuilder::from_mmaped_safetensors(&[model], DType::F32, &device)? }
+    };
+
+    let encoder_config = match args.which {
+        Which::Base => candle_transformers::models::vit::Config::microsoft_trocr_base_handwritten(),
+        Which::Large => {
+            candle_transformers::models::vit::Config::microsoft_trocr_base_handwritten()
+        }
+    };
+
+    let decoder_config = trocr::TrOCRConfig::default();
+    let mut model = trocr::TrOCRModel::new(&encoder_config, &decoder_config, vb)?;
+
+    let config = image_processor::ProcessorConfig::default();
+    let processor = image_processor::ViTImageProcessor::new(&config);
+
+    let image = vec![args.image.as_str()];
+    let image = processor.preprocess(image)?;
+
+    let encoder_xs = model.encoder().forward(&image)?;
+
+    let mut logits_processor =
+        candle_transformers::generation::LogitsProcessor::new(1337, None, None);
+
+    let mut token_ids: Vec<u32> = vec![decoder_config.decoder_start_token_id];
+    for index in 0..1000 {
+        let context_size = if index >= 1 { 1 } else { token_ids.len() };
+        let start_pos = token_ids.len().saturating_sub(context_size);
+        let input_ids = Tensor::new(&token_ids[start_pos..], &device)?.unsqueeze(0)?;
+
+        let logits = model.decode(&input_ids, &encoder_xs, start_pos)?;
+
+        let logits = logits.squeeze(0)?;
+        let logits = logits.get(logits.dim(0)? - 1)?;
+        let token = logits_processor.sample(&logits)?;
+        token_ids.push(token);
+
+        if let Some(t) = tokenizer_dec.next_token(token)? {
+            use std::io::Write;
+            print!("{t}");
+            std::io::stdout().flush()?;
+        }
+        if token == decoder_config.eos_token_id {
+            break;
+        }
+    }
+
+    if let Some(rest) = tokenizer_dec.decode_rest().map_err(E::msg)? {
+        print!("{rest}");
+    }
+    println!();
+
+    Ok(())
+}
diff --git a/candle-examples/examples/trocr/readme.md b/candle-examples/examples/trocr/readme.md
new file mode 100644
index 00000000..329940f8
--- /dev/null
+++ b/candle-examples/examples/trocr/readme.md
@@ -0,0 +1,16 @@
+# candle-trocr
+
+`TrOCR` is a transformer OCR Model. In this example it is used to
+transcribe image text. See the associated [model
+card](https://huggingface.co/microsoft/trocr-base-printed) for details on
+the model itself.
+
+## Running an example
+
+```bash
+cargo run --example trocr --release --  --which base --cpu --image assets/trocr.png
+```
+
+```
+<s> industry , Mr. Brown commented icily . " Let us have a</s>
+```
diff --git a/candle-transformers/src/models/mod.rs b/candle-transformers/src/models/mod.rs
index 370b9108..3c025660 100644
--- a/candle-transformers/src/models/mod.rs
+++ b/candle-transformers/src/models/mod.rs
@@ -29,6 +29,7 @@ pub mod segment_anything;
 pub mod stable_diffusion;
 pub mod stable_lm;
 pub mod t5;
+pub mod trocr;
 pub mod vgg;
 pub mod vit;
 pub mod whisper;
diff --git a/candle-transformers/src/models/trocr.rs b/candle-transformers/src/models/trocr.rs
new file mode 100644
index 00000000..785b06ca
--- /dev/null
+++ b/candle-transformers/src/models/trocr.rs
@@ -0,0 +1,434 @@
+use crate::models::vit::{Config, Embeddings, Encoder};
+use candle::{Result, Tensor};
+use candle_nn::{
+    embedding, layer_norm, linear_no_bias, Embedding, LayerNorm, Linear, Module, VarBuilder,
+};
+use serde::Deserialize;
+
+#[derive(Debug, Clone, PartialEq, Deserialize)]
+pub struct TrOCRConfig {
+    pub vocab_size: usize,
+    pub d_model: usize,
+    pub hidden_size: usize,
+    pub decoder_layers: usize,
+    pub decoder_attention_heads: usize,
+    pub decoder_ffn_dim: usize,
+    pub activation_function: candle_nn::Activation,
+    pub max_position_embeddings: usize,
+    pub dropout: f64,
+    pub attention_dropout: f64,
+    pub activation_dropout: f64,
+    pub decoder_start_token_id: u32,
+    pub init_std: f64,
+    pub decoder_layerdrop: f64,
+    pub use_cache: bool,
+    pub scale_embedding: bool,
+    pub use_learned_position_embeddings: bool,
+    pub layernorm_embedding: bool,
+    pub pad_token_id: usize,
+    pub bos_token_id: usize,
+    pub eos_token_id: u32,
+    pub num_attention_heads: usize,
+    pub decoder_vocab_size: Option<usize>,
+}
+
+impl Default for TrOCRConfig {
+    fn default() -> Self {
+        Self {
+            vocab_size: 50265,
+            d_model: 1024,
+            hidden_size: 768,
+            decoder_layers: 12,
+            decoder_attention_heads: 16,
+            decoder_ffn_dim: 4096,
+            activation_function: candle_nn::Activation::Gelu,
+            max_position_embeddings: 512,
+            dropout: 0.1,
+            attention_dropout: 0.0,
+            activation_dropout: 0.0,
+            decoder_start_token_id: 2,
+            init_std: 0.02,
+            decoder_layerdrop: 0.0,
+            use_cache: true,
+            scale_embedding: false,
+            use_learned_position_embeddings: true,
+            layernorm_embedding: true,
+            pad_token_id: 1,
+            bos_token_id: 0,
+            eos_token_id: 2,
+            num_attention_heads: 12,
+            decoder_vocab_size: Some(50265),
+        }
+    }
+}
+
+#[derive(Debug, Clone)]
+struct TrOCRLearnedPositionalEmbedding {
+    offset: usize,
+    weights: Embedding,
+}
+
+impl TrOCRLearnedPositionalEmbedding {
+    fn load(vb: VarBuilder, cfg: &TrOCRConfig) -> Result<Self> {
+        let offset: usize = 2;
+        let num_embeddings = cfg.max_position_embeddings;
+        let embedding_dim = cfg.d_model;
+        let weights = embedding(num_embeddings + offset, embedding_dim, vb)?;
+
+        Ok(Self { offset, weights })
+    }
+
+    fn forward(&mut self, input_ids: &Tensor, past_key_values_length: u32) -> Result<Tensor> {
+        let (b_sz, seq_len) = input_ids.dims2()?;
+
+        let mut positions = Tensor::arange(
+            past_key_values_length,
+            seq_len as u32 + past_key_values_length,
+            input_ids.device(),
+        )?
+        .expand((b_sz, seq_len))?;
+
+        positions =
+            positions.broadcast_add(&Tensor::new(self.offset as u32, input_ids.device())?)?;
+        self.weights.forward(&positions)
+    }
+}
+
+#[derive(Debug, Clone)]
+struct TrOCRAttention {
+    head_dim: usize,
+    num_heads: usize,
+    is_decoder: bool,
+    scaling: f64,
+    k_proj: Linear,
+    v_proj: Linear,
+    q_proj: Linear,
+    out_proj: Linear,
+    kv_cache: Option<(Tensor, Tensor)>,
+}
+
+impl TrOCRAttention {
+    fn load(
+        vb: VarBuilder,
+        cfg: &TrOCRConfig,
+        kdim: Option<usize>,
+        vdim: Option<usize>,
+    ) -> Result<Self> {
+        let embed_dim = cfg.d_model;
+        let num_heads = cfg.decoder_attention_heads;
+        let head_dim = embed_dim / num_heads;
+        let kdim = kdim.unwrap_or(embed_dim);
+        let vdim = vdim.unwrap_or(embed_dim);
+
+        let k_proj = linear_no_bias(kdim, embed_dim, vb.pp("k_proj"))?;
+        let v_proj = linear_no_bias(vdim, embed_dim, vb.pp("v_proj"))?;
+        let q_proj = linear_no_bias(embed_dim, embed_dim, vb.pp("q_proj"))?;
+
+        let out_proj = linear_no_bias(embed_dim, embed_dim, vb.pp("out_proj"))?;
+        Ok(Self {
+            head_dim,
+            num_heads,
+            is_decoder: true,
+            scaling: 1. / (head_dim as f64).sqrt(),
+            k_proj,
+            v_proj,
+            q_proj,
+            out_proj,
+            kv_cache: None,
+        })
+    }
+
+    fn _shape(&self, tensor: &Tensor, bsz: usize) -> Result<Tensor> {
+        tensor
+            .reshape((bsz, (), self.num_heads, self.head_dim))?
+            .transpose(1, 2)?
+            .contiguous()
+    }
+
+    fn forward(
+        &mut self,
+        xs: &Tensor,
+        kv_states: Option<&Tensor>,
+        attn_mask: Option<&Tensor>,
+    ) -> Result<Tensor> {
+        let (b_sz, tgt_len, _) = xs.dims3()?;
+        let query_states = (xs.apply(&self.q_proj)? * self.scaling)?;
+        let (key_states, value_states) = match kv_states {
+            None => {
+                let key_states = self._shape(&xs.apply(&self.k_proj)?, b_sz)?;
+                let value_states = self._shape(&xs.apply(&self.v_proj)?, b_sz)?;
+                if self.is_decoder {
+                    let kv_states = match &self.kv_cache {
+                        None => (key_states, value_states),
+                        Some((p_key_states, p_value_states)) => {
+                            let key_states = Tensor::cat(&[p_key_states, &key_states], 2)?;
+                            let value_states = Tensor::cat(&[p_value_states, &value_states], 2)?;
+                            (key_states, value_states)
+                        }
+                    };
+                    self.kv_cache = Some(kv_states.clone());
+                    kv_states
+                } else {
+                    (key_states, value_states)
+                }
+            }
+            Some(kv_states) => {
+                let key_states = self._shape(&kv_states.apply(&self.k_proj)?, b_sz)?;
+                let value_states = self._shape(&kv_states.apply(&self.v_proj)?, b_sz)?;
+                (key_states, value_states)
+            }
+        };
+        let proj_shape = (b_sz * self.num_heads, (), self.head_dim);
+        let query_states = self._shape(&query_states, b_sz)?.reshape(proj_shape)?;
+        let key_states = key_states.reshape(proj_shape)?;
+        let value_states = value_states.reshape(proj_shape)?;
+        let attn_weights = query_states.matmul(&key_states.transpose(1, 2)?)?;
+        let attn_weights = match attn_mask {
+            None => attn_weights,
+            Some(attn_mask) => attn_weights.broadcast_add(attn_mask)?,
+        };
+        let attn_probs = candle_nn::ops::softmax_last_dim(&attn_weights)?;
+        let attn_output = attn_probs.matmul(&value_states)?;
+        attn_output
+            .reshape((b_sz, self.num_heads, tgt_len, self.head_dim))?
+            .transpose(1, 2)?
+            .reshape((b_sz, tgt_len, self.head_dim * self.num_heads))?
+            .apply(&self.out_proj)
+    }
+}
+
+#[derive(Debug, Clone)]
+struct TrOCRDecoderLayer {
+    self_attn: TrOCRAttention,
+    activation_fn: candle_nn::Activation,
+    self_attn_layer_norm: LayerNorm,
+    encoder_attn: TrOCRAttention,
+    encoder_attn_layer_norm: LayerNorm,
+    fc1: Linear,
+    fc2: Linear,
+    final_layer_norm: LayerNorm,
+}
+
+impl TrOCRDecoderLayer {
+    fn load(vb: VarBuilder, cfg: &TrOCRConfig) -> Result<Self> {
+        let embed_dim = cfg.d_model;
+        let self_attn = TrOCRAttention::load(vb.pp("self_attn"), cfg, None, None)?;
+        let self_attn_layer_norm = layer_norm(embed_dim, 1e-5, vb.pp("self_attn_layer_norm"))?;
+        let encoder_attn = TrOCRAttention::load(
+            vb.pp("encoder_attn"),
+            cfg,
+            Some(cfg.hidden_size),
+            Some(cfg.hidden_size),
+        )?;
+        let encoder_attn_layer_norm =
+            layer_norm(embed_dim, 1e-5, vb.pp("encoder_attn_layer_norm"))?;
+        let fc1 = linear_no_bias(embed_dim, cfg.decoder_ffn_dim, vb.pp("fc1"))?;
+        let fc2 = linear_no_bias(cfg.decoder_ffn_dim, embed_dim, vb.pp("fc2"))?;
+        let final_layer_norm = layer_norm(embed_dim, 1e-5, vb.pp("final_layer_norm"))?;
+        let activation_fn = candle_nn::Activation::Gelu;
+
+        Ok(Self {
+            self_attn,
+            activation_fn,
+            self_attn_layer_norm,
+            encoder_attn,
+            encoder_attn_layer_norm,
+            fc1,
+            fc2,
+            final_layer_norm,
+        })
+    }
+
+    fn forward(
+        &mut self,
+        xs: &Tensor,
+        attention_mask: &Tensor,
+        encoder_hidden_states: Option<&Tensor>,
+    ) -> Result<Tensor> {
+        let residual = xs.clone();
+        let xs = self.self_attn.forward(xs, None, Some(attention_mask))?;
+        let xs = (xs + residual)?;
+        let mut xs = self.self_attn_layer_norm.forward(&xs)?;
+
+        if let Some(encoder_hidden_states) = &encoder_hidden_states {
+            let residual = xs.clone();
+            let encoder_attention_mask = attention_mask.clone(); // TODO
+            xs = self.encoder_attn.forward(
+                &xs,
+                Some(encoder_hidden_states),
+                Some(&encoder_attention_mask),
+            )?;
+            xs = (xs + residual)?;
+            xs = self.encoder_attn_layer_norm.forward(&xs)?
+        }
+
+        let residual = xs.clone();
+        let xs = self.fc1.forward(&xs)?;
+        let xs = self.activation_fn.forward(&xs)?;
+        let xs = self.fc2.forward(&xs)?;
+        let xs = (xs + residual)?;
+        let xs = self.final_layer_norm.forward(&xs)?;
+
+        Ok(xs)
+    }
+}
+
+#[derive(Debug, Clone)]
+pub struct TrOCRDecoder {
+    layers: Vec<TrOCRDecoderLayer>,
+    embed_scale: Option<f64>,
+    embed_tokens: Embedding,
+    embed_positions: TrOCRLearnedPositionalEmbedding,
+}
+
+impl TrOCRDecoder {
+    fn new(cfg: &TrOCRConfig, vb: VarBuilder) -> Result<Self> {
+        let vb = vb.pp("decoder.model.decoder");
+
+        let embed_tokens = embedding(cfg.vocab_size, cfg.d_model, vb.pp("embed_tokens"))?;
+        let embed_positions = TrOCRLearnedPositionalEmbedding::load(vb.pp("embed_positions"), cfg)?;
+        let mut layers = Vec::with_capacity(cfg.decoder_layers);
+        let vb_l = vb.pp("layers");
+        for idx in 0..cfg.decoder_layers {
+            let layer = TrOCRDecoderLayer::load(vb_l.pp(idx), cfg)?;
+            layers.push(layer)
+        }
+        let embed_scale = if cfg.scale_embedding {
+            Some((cfg.d_model as f64).sqrt())
+        } else {
+            None
+        };
+
+        Ok(Self {
+            layers,
+            embed_scale,
+            embed_tokens,
+            embed_positions,
+        })
+    }
+
+    pub fn forward(
+        &mut self,
+        xs: &Tensor,
+        encoder_xs: Option<&Tensor>,
+        past_kv_len: usize,
+        attn_mask: &Tensor,
+    ) -> Result<Tensor> {
+        let embed_pos = self.embed_positions.forward(xs, past_kv_len as u32)?;
+        let xs = xs.apply(&self.embed_tokens)?;
+
+        let xs = match self.embed_scale {
+            None => xs,
+            Some(scale) => (xs * scale)?,
+        };
+
+        let mut xs = xs.broadcast_add(&embed_pos)?;
+
+        for layer in self.layers.iter_mut() {
+            xs = layer.forward(&xs, attn_mask, encoder_xs)?;
+        }
+        Ok(xs)
+    }
+}
+
+#[derive(Debug, Clone)]
+pub struct TrOCREncoder {
+    embeddings: Embeddings,
+    encoder: Encoder,
+    layernorm: LayerNorm,
+}
+
+impl TrOCREncoder {
+    pub fn new(cfg: &Config, vb: VarBuilder) -> Result<Self> {
+        let vb_v = vb.pp("encoder");
+
+        let embeddings = Embeddings::new(cfg, false, vb_v.pp("embeddings"))?;
+
+        let encoder = Encoder::new(cfg, vb_v.pp("encoder"))?;
+        let layernorm = layer_norm(cfg.hidden_size, cfg.layer_norm_eps, vb_v.pp("layernorm"))?;
+
+        Ok(Self {
+            embeddings,
+            encoder,
+            layernorm,
+        })
+    }
+
+    pub fn forward(&self, xs: &Tensor) -> Result<Tensor> {
+        let embedding_output = self.embeddings.forward(xs, None, false)?;
+        let encoder_outputs = self.encoder.forward(&embedding_output)?;
+
+        self.layernorm.forward(&encoder_outputs)
+    }
+}
+
+#[derive(Debug, Clone)]
+pub struct TrOCRForCausalLM {
+    decoder: TrOCRDecoder,
+    output_projection: Linear,
+}
+
+impl TrOCRForCausalLM {
+    pub fn new(decoder_cfg: &TrOCRConfig, vb: VarBuilder) -> Result<Self> {
+        let decoder = TrOCRDecoder::new(decoder_cfg, vb.clone())?;
+        let output_projection =
+            candle_nn::Linear::new(decoder.embed_tokens.embeddings().clone(), None);
+        Ok(Self {
+            decoder,
+            output_projection,
+        })
+    }
+
+    pub fn forward(
+        &mut self,
+        xs: &Tensor,
+        encoder_xs: Option<&Tensor>,
+        past_kv_len: usize,
+        attn_mask: &Tensor,
+    ) -> Result<Tensor> {
+        let xs = self
+            .decoder
+            .forward(xs, encoder_xs, past_kv_len, attn_mask)?;
+        let xs = xs.apply(&self.output_projection)?;
+
+        Ok(xs)
+    }
+}
+
+#[derive(Debug, Clone)]
+pub struct TrOCRModel {
+    encoder: TrOCREncoder,
+    decoder: TrOCRForCausalLM,
+}
+
+impl TrOCRModel {
+    pub fn new(encoder_cfg: &Config, decoder_cfg: &TrOCRConfig, vb: VarBuilder) -> Result<Self> {
+        let encoder = TrOCREncoder::new(encoder_cfg, vb.clone())?;
+        let decoder = TrOCRForCausalLM::new(decoder_cfg, vb)?;
+        Ok(Self { encoder, decoder })
+    }
+
+    pub fn encoder(&mut self) -> &mut TrOCREncoder {
+        &mut self.encoder
+    }
+
+    pub fn decoder(&mut self) -> &mut TrOCRForCausalLM {
+        &mut self.decoder
+    }
+
+    pub fn decode(
+        &mut self,
+        xs: &Tensor,
+        encoder_xs: &Tensor,
+        past_kv_len: usize,
+    ) -> Result<Tensor> {
+        let seq_len = xs.dim(1)?;
+        let mask: Vec<_> = (0..seq_len)
+            .flat_map(|i| (0..seq_len).map(move |j| if j > i { f32::NEG_INFINITY } else { 0f32 }))
+            .collect();
+        let mask = Tensor::from_vec(mask, (seq_len, seq_len), xs.device())?;
+
+        self.decoder
+            .forward(xs, Some(encoder_xs), past_kv_len, &mask)
+    }
+}
diff --git a/candle-transformers/src/models/vit.rs b/candle-transformers/src/models/vit.rs
index e2218c54..962528c1 100644
--- a/candle-transformers/src/models/vit.rs
+++ b/candle-transformers/src/models/vit.rs
@@ -6,16 +6,16 @@ use candle_nn::{layer_norm, LayerNorm, VarBuilder};
 // https://github.com/huggingface/transformers/blob/main/src/transformers/models/vit/configuration_vit.py
 #[derive(Debug, Clone)]
 pub struct Config {
-    hidden_size: usize,
-    num_hidden_layers: usize,
-    num_attention_heads: usize,
-    intermediate_size: usize,
-    hidden_act: candle_nn::Activation,
-    layer_norm_eps: f64,
-    image_size: usize,
-    patch_size: usize,
-    num_channels: usize,
-    qkv_bias: bool,
+    pub hidden_size: usize,
+    pub num_hidden_layers: usize,
+    pub num_attention_heads: usize,
+    pub intermediate_size: usize,
+    pub hidden_act: candle_nn::Activation,
+    pub layer_norm_eps: f64,
+    pub image_size: usize,
+    pub patch_size: usize,
+    pub num_channels: usize,
+    pub qkv_bias: bool,
 }
 
 impl Config {
@@ -34,6 +34,21 @@ impl Config {
             qkv_bias: true,
         }
     }
+
+    pub fn microsoft_trocr_base_handwritten() -> Self {
+        Self {
+            hidden_size: 768,
+            num_hidden_layers: 12,
+            num_attention_heads: 12,
+            intermediate_size: 3072,
+            hidden_act: candle_nn::Activation::Gelu,
+            layer_norm_eps: 1e-12,
+            image_size: 384,
+            patch_size: 16,
+            num_channels: 3,
+            qkv_bias: false,
+        }
+    }
 }
 
 #[derive(Debug, Clone)]
@@ -76,7 +91,7 @@ impl Module for PatchEmbeddings {
 }
 
 #[derive(Debug, Clone)]
-struct Embeddings {
+pub struct Embeddings {
     cls_token: Tensor,
     mask_token: Option<Tensor>,
     patch_embeddings: PatchEmbeddings,
@@ -85,7 +100,7 @@ struct Embeddings {
 }
 
 impl Embeddings {
-    fn new(cfg: &Config, use_mask_token: bool, vb: VarBuilder) -> Result<Self> {
+    pub fn new(cfg: &Config, use_mask_token: bool, vb: VarBuilder) -> Result<Self> {
         let hidden_size = cfg.hidden_size;
         let cls_token = vb.get((1, 1, hidden_size), "cls_token")?;
         let mask_token = if use_mask_token {
@@ -115,7 +130,7 @@ impl Embeddings {
         todo!()
     }
 
-    fn forward(
+    pub fn forward(
         &self,
         pixel_values: &Tensor,
         bool_masked_pos: Option<&Tensor>,
@@ -324,12 +339,12 @@ impl Module for Layer {
 }
 
 #[derive(Debug, Clone)]
-struct Encoder {
+pub struct Encoder {
     layers: Vec<Layer>,
 }
 
 impl Encoder {
-    fn new(cfg: &Config, vb: VarBuilder) -> Result<Self> {
+    pub fn new(cfg: &Config, vb: VarBuilder) -> Result<Self> {
         let vb = vb.pp("layer");
         let mut layers = Vec::with_capacity(cfg.num_hidden_layers);
         for i in 0..cfg.num_hidden_layers {