InstantID

InstantID

一个围绕 InstantX/InstantID 模型搭建的 Gradio 演示，带有 Stable Diffusion XL 流水线、ControlNet 深度和边缘模型以及风格模板，可以在线运行，也可以在你的电脑上运行。

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

简介

它是什么：InstantID 是 InstantX 发布在 Hugging Face Space 上的一个 Gradio 演示。它提到了 InstantX/InstantID 模型，以及 ControlNet 深度和边缘模型、一个 SDXL 用的 LCM LoRA 和一个 Depth Anything 模型。仓库里有一个 SDXL 流水线文件、一个风格模板文件，以及放示例、模型和 IP 适配器的文件夹。

适合谁：适合想在浏览器里试用 InstantID 模型的人，也适合想阅读或自己运行较大的图像生成演示的开发者。

行业 | 谁在用 | 怎么用 | 例子
创意工作 | 做图的人 | 打开这个 Space，试用它提到的模型 | 在本地运行任何东西之前，先看看演示提供什么
机器学习 | 研究者 | 下载文件，阅读流水线代码 | 研究模型、ControlNet 和 IP 适配器是怎么组合在一起的
软件开发 | Gradio 开发者 | 阅读 app.py 和风格模板文件 | 看较大的图像演示在 Gradio 里是怎么布局的

如果你想要一个带 API 的托管服务，可以跳过它，因为这是需要你自己打开或运行的应用。

用在哪里：InstantID 可以在这些地方运行。

• 网页浏览器：打开它在 Hugging Face 上的 Space 页面
• Windows、macOS 或 Linux 上的 Python：运行 Space 的一份副本

用途 | 谁用 | 能得到什么
在线试用 | 任何有浏览器的人 | 从 Space 运行的 Gradio 演示
本地运行 | 有 Python 的开发者 | 从 app.py 启动的一份应用副本
阅读代码 | 学习者 | 流水线文件、风格模板、示例和 IP 适配器文件夹

如何设置：在线使用只需要一个浏览器。想放一份本地副本，要先准备几样东西。

• 在线 Space 需要一个网页浏览器
• 本地副本需要 Windows、macOS 或 Linux 上的 Python
• requirements.txt 里列出的 Python 包

1. 用 pip 安装 Hugging Face hub 库。
2. 把这个 Space 的文件下载到名为 InstantID 的文件夹里。
3. 进入这个文件夹。
4. 安装 Space 使用的那个版本的 Gradio。
5. 安装 requirements.txt 里列出的包。
6. 用 Python 启动应用。

pip install -U huggingface_hub
hf download InstantX/InstantID --repo-type space --local-dir InstantID
cd InstantID
pip install gradio==4.40.0
pip install -r requirements.txt
python app.py

如何使用：在线使用时，打开 Space 页面，在你的标签页里使用演示。在自己的电脑上，就在这个文件夹里用下面的命令启动应用。

python app.py

工具 | 作用
python app.py | 从主文件启动 Gradio 应用
pip install -r requirements.txt | 安装应用需要的包
hf download | 把这个 Space 的文件取到本地文件夹

示例：你用 hf 命令下载这个 Space，安装 Gradio 4.40.0 和列出的包，再运行 python app.py。演示会从你本地的文件副本启动。

新手与专家：如果你是新手，先打开 Space 页面，看看演示提供什么。在线运行不需要任何设置，所以先从这里开始，再去试本地副本。

如果你熟悉这个领域，仓库打包了一个给 InstantID 用的 SDXL 流水线文件、一个 IP 适配器文件夹和一个 torchhub 文件夹，并提到深度和边缘 ControlNet 检查点。本地副本固定使用 Gradio 4.40.0。Space 本身在 Hugging Face 上用 zero-a10g 硬件，所以本地运行取决于你自己的机器。

打开 Space 或运行 app.py
Gradio 提供演示
你在浏览器里使用

注意事项：它只是一个 Gradio 演示，所以你能做的事仅限于它的页面所提供的。

• Version: Gradio 4.40.0
• Models named: 六个仓库，涵盖 InstantID、两个 ControlNet 检查点、一个 LCM LoRA、Depth Anything 和原版 ControlNet
• Size: 仓库里有 107 个文件
• License: apache-2
• Cost to run: 没有提到
• Data it reaches: 它提到的这些模型，没有提到别的
• Not for: 没有提到禁止的用途

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

• 点赞：3,659
• 构建方式：gradio
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/InstantX/InstantID
• 文件：https://huggingface.co/spaces/InstantX/InstantID/tree/main

试用

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