rlx-flow 0.2.1

Block assembly-line API for RLX model builders — fusion-first, config-driven
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39

// RLX — versatile ML compiler + runtime.
// Copyright (C) 2026 Eugene Hauptmann, Nataliya Kosmyna.

use anyhow::Result;
use rlx_ir::HirGraphExt;
use rlx_ir::hir::HirMut;
use rlx_ir::op::Activation;
use rlx_ir::{DType, Shape};

use super::BlockStage;
use crate::context::FlowCtx;
use crate::value::FlowValue;

/// Gemma 2 final logit softcap: `cap * tanh(logits / cap)`.
#[derive(Debug, Clone)]
pub struct LogitSoftcapStage {
    pub cap: f32,
}

impl LogitSoftcapStage {
    pub fn new(cap: f32) -> Self {
        Self { cap }
    }
}

impl BlockStage for LogitSoftcapStage {
    fn emit(&self, ctx: &mut FlowCtx<'_>, input: FlowValue) -> Result<Option<FlowValue>> {
        let cap = self.cap;
        let inv_name = format!("gemma.logit_softcap.inv.{cap}");
        let inv = ctx.synth_param(&inv_name, vec![1.0 / cap], Shape::new(&[1], DType::F32));
        let cap_name = format!("gemma.logit_softcap.cap.{cap}");
        let cap_id = ctx.synth_param(&cap_name, vec![cap], Shape::new(&[1], DType::F32));
        let mut gb = HirMut::new(ctx.hir());
        let scaled = gb.mul(input.id, inv);
        let t = gb.activation(Activation::Tanh, scaled, gb.shape(scaled).clone());
        let out = gb.mul(t, cap_id);
        Ok(Some(ctx.wrap(out, input.shape.clone())))
    }
}