Iris-3B

Iris-3B

Iris-3B 的演示。这个 3B 模型能根据文字生成图片、从单张图片估计深度，并修复或放大图片。适合想试用通用图像模型的视觉研究者和开发者。

由 speridlabs 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这个 Space 是 Iris-3B 的演示，这是一个直接在像素空间里工作的通用视觉模型。同一个 3B 模型负责文生图、从单张图片估计深度、图像修复和放大。它运行在 Hugging Face 的 ZeroGPU 上，背后有一篇研究论文。

适合谁：想用同一个模型试多种图像任务的计算机视觉研究者、开发者和好奇的创作者。

Industry | Who uses it | How they use it | Example
研究 | 视觉研究者 | 在生成、深度和修复上测试同一个模型 | 运行预设示例并对比输出
软件 | 图像开发者 | 研究像素空间模型如何包进演示 | 阅读 app.py、viewers.py 和 iris3b 文件夹
创意 | 设计师 | 根据提示词生成图片 | 输入一个场景并选择尺寸
摄影 | 照片编辑者 | 修复或放大一张图片 | 添加一张图片并运行修复任务

如果你想要成品的消费级编辑器，研究演示的打磨控件会少一些。

用在哪里：它可以在两个地方运行。

• 网页浏览器，在 Hugging Face 上的 Space 页面打开，无需安装任何东西
• Windows、macOS 或 Linux 上的本地副本，需要 Python 3.12

Use case | Who | What they get back
文生图 | 创作者 | 根据你的提示词生成的图片
单张图片估计深度 | 研究者 | 单张图片的深度估计图
修复或放大 | 照片编辑者 | 更干净或更大的图片版本

如何设置：在线使用什么都不用准备。本地副本需要更多东西。

• Python 3.12 和 pip
• requirements.txt 里列出的包
• 一个名为 HF_TOKEN 的 Hugging Face 令牌密钥，只有在模型仓库是私有的时候才需要
• 适合 3B 模型的 GPU，因为页面是为 ZeroGPU 搭建的

1. 安装 Hugging Face 工具。
2. 把这个 Space 下载到一个文件夹。
3. 进入该文件夹。
4. 安装 Gradio 和 requirements.txt 里的包。
5. 启动应用。

pip install -U huggingface_hub
hf download speridlabs/iris-3b --repo-type space --local-dir iris-3b
cd iris-3b
pip install gradio==5.49.1
pip install -r requirements.txt
python app.py

如何使用：打开 Space 页面，选一个任务。你可以从精选的示例预设开始，每个预设都记录了它的提示词、尺寸、种子、步数和引导强度。改动这些值来探索。应用会从 IRIS_MODEL_REPO 设置所指向的模型仓库加载导出的权重。

Tool | What it does
文生图 | 根据书面提示词生成图片
单目深度 | 从单张图片估计深度
图像修复 | 清理受损或有噪点的图片
放大 | 把图片变大

示例：你打开一个预设，读它的提示词和采样时用的设置，然后改变种子再运行一次。页面会显示同一个提示词生成的新图片。

新手与专家：先用一个预设，看看能得到什么质量，再一次只改一个设置。种子决定随机起点，步数和引导强度则影响结果。

像素空间的意思是模型直接处理像素，而不是压缩后的潜在表示。一个 3B 的先验模型服务多个任务。权重从一个 safetensors 文件和一个配置文件加载，iris3b 文件夹是代码仓库里源码包的副本。这个 Space 还列出了 Qwen3-VL 4B Instruct 模型。

你选择任务和设置
应用加载导出的 Iris-3B 权重
3B 像素空间模型在 ZeroGPU 上运行
结果显示在页面里

注意事项：README 很简短，所以各任务支持的尺寸和限制都没有列出。

• License: Apache 2.0
• Cost to run: Hugging Face 上的 ZeroGPU 时间，只有在模型仓库是私有时才需要 HF_TOKEN 密钥
• Data it reaches: 你添加的提示词和图片，以及来自 Hub 的模型文件

Hugging Face 上的数据（2026年11月13日）

• 点赞：65
• 构建方式：gradio
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/speridlabs/iris-3b
• 文件：https://huggingface.co/spaces/speridlabs/iris-3b/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。