Highlights
Adds first-class support for JEPA-family joint-embedding world models (#1).
New JepaAdapter
Convert V-JEPA 2, I-JEPA, and LeWorldModel checkpoints to verified .n.orca.md:
n-orca hf convert facebook/vjepa2-vitl-fpc64-256 --out vjepa2.n.orca.md --mermaid vjepa2.mmd
n-orca hf convert quentinll/lewm-pusht --out lewm-pusht.n.orca.md- Normalizes the flat HF
transformersconfig (V-JEPA 2 / I-JEPA,pred_*fields) and the nested Hydra config (LeWorldModel, matched structurally — nomodel_type) into one encoder → predictor DAG. - Dual latent outputs (
encoder_latents,predicted_latents) share the encoder's embedding space; anoutput_shapeinvariant enforces latent-dim consistency. - Optional additive action conditioning and projector head. Mask tokens, the EMA stop-gradient target, SIGReg, and rotary/sincos positions are captured as verification rules.
New ops
TubeletEmbed(Conv3d, video) andPatchEmbed(Conv2d, image) patch embedders — shape inference + param counting that matches PyTorch exactly.
CLI
n-orca hf download --include-processoralso fetchespreprocessor_config.json/video_preprocessor_config.json(V-JEPA ships the latter).
Examples
examples/hf-generated/vjepa2.n.orca.md(V-JEPA 2 ViT-L, 326M params) andlewm-pusht.n.orca.md(action-conditioned), each with a matching.mmd.
Tests
- 140 passing (+22): new ops, dispatch incl. structural LeWM detection, verify, parser round-trip, Mermaid, and torch forward passes.
Full diff: v0.1.0...v0.2.0