Speridlabs Iris-Z

Speridlabs Iris-Z is FLUX.2 fine-tuned to denoise an image and its depth in one sequence. The same weights generate images from a prompt, estimate depth from a photo in 4 steps, paint a prompt onto a given depth, and return an image together with its depth. LibreYOLO runs it through the LibreGen factory in two sizes.

작업
image generation, depth
크기
9b, 32b at 1024 px
설치
pip install "libreyolo[gen]"
지원 티어
별도 티어, v1.8.0부터 지원. 자체 팩토리와 계약을 갖춘 별도의 제품 영역입니다.
업스트림
Speridlabs의 Speridlabs Iris-Z, FLUX Non-Commercial License. 논문, 소스
라이선스
코드 MIT and Apache-2.0, 가중치 FLUX Non-Commercial License. 상업적 사용

Install

bash
pip install "libreyolo[gen]"

Predict

The task is fixed when the model loads: task="depth" for image to depth, the default generate for the other three modes. A depth model never loads a text encoder.

Image to depth
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("speridlabs-iris-z", task="depth")   # 9b; loads no text encoderresult = model(SAMPLE_IMAGE) depth = result.depth_mapprint(depth.encoding)          # "log_depth": larger is fartherprint(depth.data.shape)        # (H, W) at the photo's sizeprint(depth.valid_mask.shape)  # False on skyresult.save("depth.png")       # coloured depth
Text to image
from libreyolo import LibreGen model = LibreGen("speridlabs-iris-z")result = model("a lighthouse at dusk", seed=0)result.generated.save("lighthouse.png")
Depth to image
from libreyolo import LibreGen, SAMPLE_IMAGE model = LibreGen("speridlabs-iris-z")# The photo's depth is estimated first, then a new scene is painted on it.result = model("a sunken ruin under the sea", source=SAMPLE_IMAGE, seed=0)result.generated.save("ruin.png")
Image plus depth
from libreyolo import LibreGen model = LibreGen("speridlabs-iris-z")result = model("a grand old library, a spiral staircase", depth=True, seed=0)result.generated.save("library.png")print(result.depth_map.data.shape)
CLI
libreyolo generate prompt="a lighthouse at dusk" model=speridlabs-iris-zlibreyolo generate source=https://raw.githubusercontent.com/LibreYOLO/libreyolo/release/libreyolo/assets/guggenheim-bilbao.jpg task=depthlibreyolo generate source=photos/ task=depth ensemble=10 imgsz=1024

Image to depth. Sources are what predict takes. result.depth_map is a DepthMap with encoding="log_depth" (relative log depth, larger is farther) at the source's size, and valid_mask is False on sky. imgsz is the working resolution, 512 or 1024 (default 512 under half a megapixel, else 1024). Knobs: steps (4) and ensemble (1), the per-pixel median over that many seeds. The default seed is 0, so depth repeats. save=True writes the coloured map under runs/depth/predict.

Text to image. Prompts, imgsz, seed and n work as for every image generation model. Knobs: steps (50) and guidance (4.0 for 9b, 3.5 for 32b).

Depth to image. source= on the generate task is the depth the image is painted on: a photo (its depth is estimated first), a Results or DepthMap from any depth model, or a grayscale depth image with depth_format="depth" (bright is far) or "disparity" (bright is near). An image is only read as a depth map when depth_format says so. The output keeps the depth's aspect ratio, and Results.depth_map is the depth it was painted on.

Image plus depth. depth=True samples image and depth jointly, then re-estimates the depth from the finished image, as upstream does by default. The result carries both result.generated and result.depth_map.

The CLI covers text to image and image to depth; prompt= and source= stay mutually exclusive there.

Variants

SizeAliasParametersText encoderGPU memory (library figure)
9bsperidlabs-iris-z, -9b, -small9.1B, from FLUX.2 [klein] Base 9BQwen3 8B FP8about 18 GB, plus 9 GB text encoder and 0.2 GB VAE
32bsperidlabs-iris-z-32b, -big32.2B, from FLUX.2 [dev]Mistral Small 3.2 24Babout 64 GB, plus 48 GB text encoder and 0.2 GB VAE

offload=True keeps the text encoder on the CPU between prompts. On CUDA without the FP8 kernel that transformers asks for (the kernels package), and on MPS or CPU, the 9b text encoder runs dequantized in bfloat16, close to but not identical with upstream's embeddings. A local snapshot or variant folder loads with LibreGen(path).

Export

작업ONNXTorchScriptExecuTorchTensorRTOpenVINOPaddleMNNRKNNAxelerancnnTFLiteCoreMLCore AI
Image generationImage generation to ONNX: 지원하지 않음Image generation to TorchScript: 지원하지 않음Image generation to ExecuTorch: 지원하지 않음Image generation to TensorRT: 지원하지 않음Image generation to OpenVINO: 지원하지 않음Image generation to Paddle: 지원하지 않음Image generation to MNN: 지원하지 않음Image generation to RKNN: 지원하지 않음Image generation to Axelera: 지원하지 않음Image generation to ncnn: 지원하지 않음Image generation to TFLite: 지원하지 않음Image generation to CoreML: 지원하지 않음Image generation to Core AI: 지원하지 않음
DepthDepth to ONNX: 지원하지 않음Depth to TorchScript: 지원하지 않음Depth to ExecuTorch: 지원하지 않음Depth to TensorRT: 지원하지 않음Depth to OpenVINO: 지원하지 않음Depth to Paddle: 지원하지 않음Depth to MNN: 지원하지 않음Depth to RKNN: 지원하지 않음Depth to Axelera: 지원하지 않음Depth to ncnn: 지원하지 않음Depth to TFLite: 지원하지 않음Depth to CoreML: 지원하지 않음Depth to Core AI: 지원하지 않음

export(), train() and val() raise, as for every LibreGen family.

Licensing

내려받는 특정 가중치의 Hugging Face 저장소에서 라이선스를 확인하십시오. LibreYOLO 조직의 모든 체크포인트에는 라이선스가 있으며 한 계열 안에서도 항상 같지는 않습니다. 해당 저장소가 신뢰할 수 있는 기준입니다. 아래 요약은 이 페이지를 마지막으로 검증했을 때 적용된 내용을 설명합니다.

관련 라이선스에 관한 설명이며 법률 자문이 아닙니다. 상업적으로 중요한 사안이라면 라이선스를 직접 읽고 별도의 법률 자문을 받으십시오.

원작
Speridlabs Iris-Z, Speridlabs
업스트림 라이선스
FLUX Non-Commercial License
LibreYOLO 코드
MIT
가중치
FLUX Non-Commercial License, 저자가 배포합니다. LibreYOLO는 이를 호스팅하거나 미러링하지 않습니다.
해석
The Iris-Z weights are derived from FLUX.2 [dev] and FLUX.2 [klein] Base 9B and are under Black Forest Labs' FLUX Non-Commercial License, a custom agreement that is not OSI-approved: no commercial or production use, and Section 2(e) asks for content filtering or human review of generated images before they are shared. LibreYOLO's adapter is MIT; the transformer, samplers and prompt embedders it ports from the Speridlabs Iris-Z SDK keep Apache-2.0, as does the FLUX.2 code the SDK builds on, with their notices in libreyolo/models/gen/speridlabs_irisz/NOTICE. LibreYOLO does not redistribute any weights. They download at runtime, unmodified, from their publishers at pinned revisions: speridlabs/iris-z at 16239e1a5444c484b11a04b61d633eceb768574c (9b from Iris-Z-small, 32b from Iris-Z-big, not gated), the FLUX.2 VAE from black-forest-labs/FLUX.2-klein-4B (Apache-2.0), and the text encoders Qwen/Qwen3-8B-FP8 for 9b and mistralai/Mistral-Small-3.2-24B-Instruct-2506 for 32b (both Apache-2.0).

Speridlabs Iris-Z is by Speridlabs. The weights are under Black Forest Labs' FLUX Non-Commercial License: no commercial or production use, and section 2(e) asks for content filtering or human review of generated images before they are shared. LibreYOLO's adapter is MIT; the transformer, samplers and prompt embedders ported from the Iris-Z SDK keep Apache-2.0.

LibreYOLO does not redistribute any weights. They download at runtime, unmodified, from speridlabs/iris-z at a pinned revision, not gated. The FLUX.2 VAE comes from the Apache-2.0 black-forest-labs/FLUX.2-klein-4B repository, and the text encoders (Qwen/Qwen3-8B-FP8 for 9b, mistralai/Mistral-Small-3.2-24B-Instruct-2506 for 32b) are Apache-2.0.

Citation

@article{canada2026irisz,
  title   = {Iris-Z: Scaling One Generative Model Past
             Specialist Geometry Models},
  author  = {Ca{\~n}ada, Alejandro and Garabito, Chema},
  journal = {arXiv preprint arXiv:2611.16010},
  year    = {2026},
  url     = {https://arxiv.org/abs/2611.16010}
}

speridlabs.com/research/iris-z#citation에 있는 저자의 인용 블록에서 복사했습니다.

LibreYOLO v1.8.0에서 검증되었습니다. 이 페이지의 지원 표, 체크포인트, 벤치마크 수치는 출시된 라이브러리와 공개된 가중치에서 생성되며 수동으로 작성되지 않습니다.