Enum FaceEmbedder 

pub enum FaceEmbedder {
    Local(LocalEmbedder),
    Remote {
        remote: RemoteEmbedder,
        local_fallback: Option<LocalEmbedder>,
    },
}

Dispatch enum — either local ONNX or remote GPU bridge.

The Remote variant always carries a LocalEmbedder alongside it. When the remote bridge fails for a batch, we fall back to local for just that batch instead of dropping the faces silently. The remote’s own 3-strikes / unhealthy check still applies; this is the per-batch safety net while it’s nominally healthy.

Variants

Local(LocalEmbedder)

Remote

Fields

remote: RemoteEmbedder

local_fallback: Option<LocalEmbedder>

Implementations

impl FaceEmbedder

pub fn from_config( rt: &OnnxRuntime, cfg: &EmbedderConfig, ) -> Result<Self, Error>

Build the configured embedder. Always constructs a local instance — it’s required as a fallback even when the bridge is healthy. If a remote bridge URL is configured AND the bridge passes its initial health check (including model match), the returned embedder routes batches through the remote first.

pub fn embed(&mut self, aligned_face: &RgbImage) -> Option<FaceEmbedding>

Generate embedding for an aligned face image (112x112).

pub fn embed_batch(&mut self, faces: &[RgbImage]) -> Vec<Option<FaceEmbedding>>

Generate embeddings for a batch of aligned face images. Returns one Option per input; None only if both remote and local-fallback produced no embedding for that input.