能力标签
onediff Agent工作流
🛠
AI工具

onediff Agent工作流

基于 Jupyter Notebook · 开源免费,本地部署,数据完全自主可控
英文名:onediff
⭐ 2.0k Stars 🍴 129 Forks 💻 Jupyter Notebook 📄 Apache-2.0 🏷 AI 8.2分
8.2AI 综合评分
扩散模型性能加速CUDA优化ComfyUIDiffusers
✦ AI Skill Hub 推荐

onediff Agent工作流 是 AI Skill Hub 本期精选AI工具之一。已获得 2.0k 颗 GitHub Star,综合评分 8.2 分,整体质量较高。我们强烈推荐将其纳入你的 AI 工具库,帮助提升工作效率。

📚 深度解析

onediff Agent工作流 是一款基于 Jupyter 的开源工具,在 GitHub 上收获 2k+ Star,是扩散模型、性能加速、CUDA优化、ComfyUI领域中的优质开源项目。开源工具的最大优势在于代码完全透明,你可以审计每一行代码的安全性,也可以根据自身需求进行二次开发和定制。

**为什么要使用开源工具而非商业 SaaS?**
对于个人开发者和有隐私需求的用户,本地部署的开源工具意味着数据不离本机,不受第三方服务商的数据政策约束。同时,开源工具通常没有使用次数限制和月度费用,一次安装即可长期使用,对于高频使用场景的总拥有成本(TCO)远低于订阅制商业工具。

**安装与环境准备**
onediff Agent工作流 依赖 Jupyter 运行环境。建议通过 pyenv(Python)或 nvm(Node.js)管理 Jupyter 版本,避免全局环境污染。对于新手用户,推荐先创建虚拟环境(python -m venv venv && source venv/bin/activate),再安装依赖,这样即使出现问题也可以随时删除虚拟环境重新开始,不影响系统稳定性。

**社区与维护**
GitHub Issue 和 Discussion 是获取帮助的最快渠道。在提问前建议先检查 Closed Issues(已关闭的问题),大多数常见问题都已有解答。遇到 Bug 时,提供 pip list 的输出、完整错误堆栈和最小可复现示例,能显著提高开发者响应速度。AI Skill Hub 将持续追踪 onediff Agent工作流 的版本更新,及时通知重要功能变化。

📋 工具概览

专为扩散模型设计的开源加速库,提供开箱即用的性能优化方案。支持ComfyUI工作流集成、CUDA加速和Hugging Face Diffusers框架,适合AI绘画、图像生成服务部署和研究人员使用。

onediff Agent工作流 是一款基于 Jupyter Notebook 开发的开源工具,专注于 扩散模型、性能加速、CUDA优化 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

GitHub Stars
⭐ 2.0k
开发语言
Jupyter Notebook
支持平台
Windows / macOS / Linux
维护状态
正常维护,社区驱动
开源协议
Apache-2.0
AI 综合评分
8.2 分
工具类型
AI工具
Forks
129

📖 中文文档

以下内容由 AI Skill Hub 根据项目信息自动整理,如需查看完整原始文档请访问底部「原始来源」。

专为扩散模型设计的开源加速库,提供开箱即用的性能优化方案。支持ComfyUI工作流集成、CUDA加速和Hugging Face Diffusers框架,适合AI绘画、图像生成服务部署和研究人员使用。

onediff Agent工作流 是一款基于 Jupyter Notebook 开发的开源工具,专注于 扩散模型、性能加速、CUDA优化 等核心功能。作为 GitHub 开源项目,它拥有活跃的社区支持和持续的版本迭代,代码完全透明可审计,支持本地部署以保护数据隐私。无论是个人使用还是集成到企业工作流,都能提供稳定可靠的解决方案。

📌 核心特色
  • 开源免费,支持本地部署,数据完全自主可控
  • 活跃的 GitHub 开源社区,持续迭代更新
  • 提供详细文档和使用示例,新手友好
  • 支持自定义配置,灵活适配不同使用环境
  • 可作为基础组件集成进现有技术栈或进行二次开发
🎯 主要使用场景
  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发
以下安装命令基于项目开发语言和类型自动生成,实际以官方 README 为准。
安装命令
# 克隆仓库
git clone https://github.com/siliconflow/onediff
cd onediff

# 查看安装说明
cat README.md

# 按 README 完成环境依赖安装后即可使用
📋 安装步骤说明
  1. 访问 GitHub 仓库页面
  2. 按照 README 文档完成依赖安装
  3. 根据系统环境完成初始化配置
  4. 参考官方示例或文档开始使用
  5. 遇到问题可在 GitHub Issues 中查找解答
以下用法示例由 AI Skill Hub 整理,涵盖最常见的使用场景。
常用命令 / 代码示例
# 查看帮助
onediff --help

# 基本运行
onediff [options] <input>

# 详细使用说明请查阅文档
# https://github.com/siliconflow/onediff
以下配置示例基于典型使用场景生成,具体参数请参照官方文档调整。
配置示例
# onediff 配置说明
# 查看配置选项
onediff --config-example > config.yml

# 常见配置项
# output_dir: ./output
# log_level: info
# workers: 4

# 环境变量(覆盖配置文件)
export ONEDIFF_CONFIG="/path/to/config.yml"
📑 README 深度解析 真实文档 完整度 49/100 查看 GitHub 原文 →
以下内容由系统直接从 GitHub README 解析整理,保留代码块、表格与列表结构。

简介

<p align="center"> <img src="imgs/onediff_logo.png" height="100"> </p>

<p align="center"> <a href="https://pypi.org/project/onediff" target="_blank"><img src="https://img.shields.io/pypi/v/onediff"></a> <a href="https://pypistats.org/packages/onediff" target="_blank"><img src="https://img.shields.io/pypi/dm/onediff?style=square"></a> <a href="https://github.com/siliconflow/onediff?tab=Apache-2.0-1-ov-file#readme" target="_blank"><img src="https://img.shields.io/github/license/siliconflow/onediff"></a> <a href="https://github.com/siliconflow/onediff/issues?q=is%3Aissue+is%3Aclosed" target="_blank"><img src="https://img.shields.io/github/issues-closed/siliconflow/onediff?color=blue"></a> <a href="https://github.com/siliconflow/onediff/issues?q=is%3Aopen+is%3Aissue" target="_blank"><img src="https://img.shields.io/github/issues/siliconflow/onediff"></a> </p>

<p align="center"> <a href="https://github.com/siliconflow/onediff/stargazers" target="_blank"><img src="https://img.shields.io/github/stars/siliconflow/onediff?style=square&label=Stars&color=green"></a> <a href="https://twitter.com/search?q=%22onediff%22&src=typed_query&f=live" target="_blank"><img src="https://img.shields.io/badge/Twitter-Discuss-green?logo=twitter&amp"></a> <a href="https://github.com/siliconflow/onediff/actions/workflows/sd.yml" target="_blank"><img src="https://github.com/siliconflow/onediff/actions/workflows/sd.yml/badge.svg"></a> <a href="https://github.com/siliconflow/onediff/actions/workflows/examples.yml?query=event%3Aschedule" target="_blank"><img src="https://github.com/siliconflow/onediff/actions/workflows/examples.yml/badge.svg?event=schedule"></a> </p> <p align="center"> | <a href="https://github.com/siliconflow/onediff?tab=readme-ov-file#documentation"><b>Documentation</b></a> | <a href="https://github.com/siliconflow/onediff/wiki"><b>Community</b></a> | <a href="https://github.com/siliconflow/onediff/wiki/Contribution-Guide"><b>Contribution</b></a> | <a href="https://discord.gg/RKJTjZMcPQ"><b>Discord</b></a> | </p>

---

onediff is an out-of-the-box acceleration library for diffusion models, it provides: - Out-of-the-box acceleration for popular UIs/libs(such as HF diffusers and ComfyUI) - PyTorch code compilation tools and strong optimized GPU Kernels for diffusion models

More about onediff

Features

FunctionalityDetails
Compiling TimeAbout 1 minute (SDXL)
Deployment MethodsPlug and Play
Dynamic Image Size SupportSupport with no overhead
Model SupportSD1.5~2.1, SDXL, SDXL Turbo, etc.
Algorithm SupportSD standard workflow, LoRA, ControlNet, SVD, InstantID, SDXL Lightning, etc.
SD Framework SupportComfyUI, Diffusers, SD-webui
Save & Load Accelerated ModelsYes
Time of LoRA SwitchingHundreds of milliseconds
LoRA OccupancyTens of MB to hundreds of MB.
Device SupportNVIDIA GPU 3090 RTX/4090 RTX/A100/A800/A10 etc. (Compatibility with Ascend in progress)

Installation

#### 0. OS and GPU Compatibility - Linux - If you want to use onediff on Windows, please use it under WSL. - The guide to install onediff in WSL2. - NVIDIA GPUs - Compatibility with Nvidia GPUs.

#### 1. Install torch and diffusers Note: You can choose the latest versions you want for diffusers or transformers.

python3 -m pip install "torch" "transformers==4.27.1" "diffusers[torch]==0.19.3"

#### 2. Install a compiler backend When considering the choice between OneFlow and Nexfort, either one is optional, and only one is needed.

  • For DiT structural models or H100 devices, it is recommended to use Nexfort.
  • For all other cases, it is recommended to use OneFlow. Note that optimizations within OneFlow will gradually transition to Nexfort in the future.

##### Nexfort Install Nexfort is Optional. The detailed introduction of Nexfort is here.

python3 -m  pip install -U torch==2.3.0 torchvision==0.18.0 torchaudio==2.3.0 torchao==0.1
python3 -m  pip install -U nexfort

##### OneFlow Install OneFlow is Optional. > NOTE: We have updated OneFlow frequently for onediff, so please install OneFlow by the links below.

  • CUDA 11.8

For NA/EU users

  python3 -m pip install -U --pre oneflow -f https://github.com/siliconflow/oneflow_releases/releases/expanded_assets/community_cu118
  

For CN users

  python3 -m pip install -U --pre oneflow -f https://oneflow-pro.oss-cn-beijing.aliyuncs.com/branch/community/cu118
  

<details> <summary> Click to get OneFlow packages for other CUDA versions. </summary>

  • CUDA 12.1

For NA/EU users

  python3 -m pip install -U --pre oneflow -f https://github.com/siliconflow/oneflow_releases/releases/expanded_assets/community_cu122
  

For CN users

  python3 -m pip install -U --pre oneflow -f https://oneflow-pro.oss-cn-beijing.aliyuncs.com/branch/community/cu122
  

  • CUDA 12.2

For NA/EU users

  python3 -m pip install -U --pre oneflow -f https://github.com/siliconflow/oneflow_releases/releases/expanded_assets/community_cu122
  
For CN users
  python3 -m pip install -U --pre oneflow -f https://oneflow-pro.oss-cn-beijing.aliyuncs.com/branch/community/cu122
  

</details>

3. Install onediff

- From PyPI

python3 -m pip install --pre onediff
- From source
git clone https://github.com/siliconflow/onediff.git
cd onediff && python3 -m pip install -e .
Or install for development: ```

install for dev

cd onediff && python3 -m pip install -e '.[dev]'

Acceleration for production environment

#### PyTorch Module compilation - compilation with oneflow_compile #### Avoid compilation time for new input shape - Support Multi-resolution input #### Avoid compilation time for online serving Compile and save the compiled result offline, then load it online for serving - Save and Load the compiled graph - Compile at one device(such as device 0), then use the compiled result to other device(such as device 1~7). Change device of the compiled graph to do multi-process serving #### Distributed Run If you want to do distributed inference, you can use onediff's compiler to do single-device acceleration in a distributed inference engine such as xDiT

Performance comparison

<img src="imgs/replace_a100.png" height="400">

#### SDXL E2E time - Model stabilityai/stable-diffusion-xl-base-1.0; - Image size 1024*1024, batch size 1, steps 30; - NVIDIA A100 80G SXM4;

<img src="imgs/0_12_sdxl.png" height="400">

#### SVD E2E time - Model stabilityai/stable-video-diffusion-img2vid-xt; - Image size 576*1024, batch size 1, steps 25, decoder chunk size 5; - NVIDIA A100 80G SXM4;

<img src="imgs/0_12_svd.png" height="400">

Note that we haven't got a way to run SVD with TensorRT on Feb 29 2024.

🎯 aiskill88 AI 点评 A 级 2026-05-21

专业的扩散模型加速方案,集成度高支持主流框架。代码活跃度强,2k星体现社区认可度。加速库设计完善,服务于AIGC生产端场景。

📚 实用指南(长尾问题)
适合谁
  • 需要 onediff 解决具体问题的开发者与运营人员
最佳实践
  • 先在测试环境跑通最小用例,再接入生产数据
常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)
部署方案
  • 云端托管:可放在 Vercel / Railway / Fly.io 等 PaaS 平台
相关搜索
onediff 中文教程onediff 安装报错怎么办onediff 与同类工具对比onediff 最佳实践onediff 适合谁用

⚡ 核心功能

👥 适合谁
  • 需要 onediff 解决具体问题的开发者与运营人员
⭐ 最佳实践
  • 先在测试环境跑通最小用例,再接入生产数据
⚠️ 常见错误
  • API key 直接提交到 git 仓库(请用 .env 并加入 .gitignore)

👥 适合人群

AI 技术爱好者研究人员和学生开发者和工程师技术创业者

🎯 使用场景

  • 本地部署运行,保护数据隐私,满足合规要求
  • 自定义集成到现有系统,扩展技术栈能力
  • 作为开源基础组件进行商业化二次开发

⚖️ 优点与不足

✅ 优点
  • +Apache-2.0 协议,可免费商用
  • +完全开源免费,无授权费用
  • +本地部署,数据完全自主可控
  • +开发者社区支持,遇问题可查可问
⚠️ 不足
  • 安装和初始配置可能需要一定技术基础
  • 功能完整性通常不如成熟商业产品
  • 技术支持主要依赖开源社区,响应速度不稳定
⚠️ 使用须知

AI Skill Hub 为第三方内容聚合平台,本页面信息基于公开数据整理,不对工具功能和质量作任何法律背书。

建议在沙箱或测试环境中充分验证后,再部署至生产环境,并做好必要的安全评估。

📄 License 说明

✅ Apache 2.0 — 宽松开源协议,可商用,需保留版权声明和 NOTICE 文件,含专利授权条款。

🔗 相关工具推荐

📰 相关 AI 新闻
🗺️ 相关解决方案
🧩 你可能还需要
基于当前 Skill 的能力图谱,自动补全的工具组合

❓ 常见问题 FAQ

支持Hugging Face Diffusers、Stable Diffusion和ComfyUI等主流框架
💡 AI Skill Hub 点评

经综合评估,onediff Agent工作流 在AI工具赛道中表现稳健,质量优秀。如果你已有明确的使用需求,可以直接上手体验;如果还在评估阶段,建议对比同类工具后再做决策。

📚 深入学习 onediff Agent工作流
查看分步骤安装教程和完整使用指南,快速上手这款工具
🌐 原始信息
原始名称 onediff
原始描述 开源AI工作流:OneDiff: An out-of-the-box acceleration library for diffusion models.。⭐2.0k · Jupyter Notebook
Topics 扩散模型性能加速CUDA优化ComfyUIDiffusers
GitHub https://github.com/siliconflow/onediff
License Apache-2.0
语言 Jupyter Notebook
🔗 原始来源
🐙 GitHub 仓库  https://github.com/siliconflow/onediff 🌐 官方网站  https://github.com/siliconflow/onediff/wiki

收录时间:2026-05-14 · 更新时间:2026-05-16 · License:Apache-2.0 · AI Skill Hub 不对第三方内容的准确性作法律背书。

📺 订阅 AI Skill Hub Daily Telegram 频道
每天 8 条精选 AI Skill、MCP、Agent 与自动化工具推送
加入频道 →