☰
Fooocus 文本生图:一条命令到完整可用界面的最小闭环
2026/10/16 20:28:06 网站建设 项目流程

Fooocus 文本生图:一条命令到完整可用界面的最小闭环

【免费下载链接】FooocusFocus on prompting and generating项目地址: https://gitcode.com/GitHub_Trending/fo/Fooocus

它凭什么入选

假设你在做电商详情页工具,需要批量产商品概念图。商业生图接口按张计费,量一大账单很吓人。Fooocus 最亮眼的卖点是:完全离线运行,不需要调任何参数,一句短句提示词就能出可用图像。读完本文你能一条命令把它跑起来,10 分钟内拿到第一批图。

最小闭环

官方建议 Python 3.10 + conda,安装就三步:

git clone https://gitcode.com/GitHub_Trending/fo/Fooocus cd Fooocus conda env create -f environment.yaml && conda activate fooocus pip install -r requirements_versions.txt # 安装 torch 及全部依赖

预期:无报错,当前环境是 fooocus,torch 已装好。

启动只需一条命令:

python entry_with_update.py # 首次运行自动下载默认模型,约 7GB

预期:终端打印Running on local URL: http://127.0.0.1:7865,浏览器自动打开。默认预设是 presets/default.json,主模型 juggernautXL_v8Rundiffusion 会自动落进models/checkpoints/,下载慢就先手动放好文件。

首次调用:

# 浏览器已打开 127.0.0.1:7865,输入框直接输入 house in garden,点 Generate

预期:约 1 分钟后右侧 Gallery 出现 2 张 1152×896 的图。参考速度:RTX 3060 笔记本上单步约 1.35 秒,速度档位下单张图大约 30 秒。

能力与取舍

能力典型场景代价 / 限制
纯提示词生图详情页、概念稿快速出图出图风格由预设模型决定,N 卡最低 4GB 显存
预设切换(anime / realistic)不同风格线并行使用每个预设要单独下载一套模型,各占数 GB
Image Prompt(参考图驱动)保持构图、换脸、风格迁移需要 clip_vision 模型,高级选项多
Inpaint / Outpaint局部重绘、四向扩图首次使用自动下载 1.28GB 的 inpaint 专用模型
Enhance 放大成品 2 倍细化多一轮完整采样,耗时约翻倍
--listen远程端口团队共享一个实例默认无鉴权,必须配 auth.json

Fooocus 的设计取向是把采样器、CFG、分辨率、refiner 这些细节全部收进预设,只暴露提示词和输入图;代价是单图出不了"每个旋钮都自己拧"的效果,收益是接入成本降到最低。

三个旋钮

Guidance Scale(默认 4.0)

  • 控制图像跟随提示词的强度,预设默认值是 4.0。
  • 调大,风格更艺术、色彩更浓,超过 10 后纹理过饱和、画面发塑料感;调小,出图更随意,容易偏离提示词。
  • 从 4.0 起步;画面不听提示词就往上加,画面过饱和就往下压,中间不动它。

Performance(默认 Speed)

  • 控制采样步数档位和中间结果展示,Speed 步数少,Quality 步数多。
  • 切 Quality,细节更多但单图耗时接近翻倍;切 Speed,出图更快但细节偏少。
  • 首次调参用 Speed;确认提示词有效、嫌细节不够时再切 Quality 对比。

Aspect Ratio(默认 1152×896)

  • 控制输出分辨率,下拉列表是 SDXL 训练数据里效果最好的几档尺寸。
  • 换 1:1 方图适合头像类,16:9 横图适合横幅海报;随意输尺寸会命中位置编码没见过的整数,出图质量变差。
  • 只从内置列表里挑;排版对不上才需要碰。

上线前过一遍

  • 部署:共享实例用python entry_with_update.py --listen --port 8888,或 docker-compose.yml 起容器映射 7865;不要裸奔到公网。
  • 鉴权:根目录创建auth.json(密码存 SHA-256 摘要,格式见 auth-example.json);文件不存在时界面完全开放。
  • 监控指标:盯单图生成耗时,RTX 3060 上 Speed 档位单张基线约 30 秒,P95 超过基线 2 倍先怀疑显存溢出在走系统交换。
  • 日志规范:每张产出图落在outputs/的日期目录下,开启元数据后完整参数会嵌进图片,排错直接打开对应文件核对,不用翻终端历史。

排障速查

现象大概率原因一句话修复
启动报 MetadataIncompleteBuffer / PytorchStreamReader模型文件下载不全或损坏删掉该 .safetensors,重新下载放进 models/checkpoints/
卡在模型下载不动到 huggingface 的网络不稳手动下载好 juggernautXL 和 offset lora,放进 models/checkpoints/ 再启动
RuntimeError: CPUAllocator系统内存加交换不足释放到 16GB 可用内存,Windows 用户打开系统虚拟交换
生成速度比正常慢数倍高于 531 的驱动在部分机器上性能异常安装 Nvidia Driver 531 并重启
首次 Inpaint / Outpaint 失败1.28GB 的 inpaint 模型还没下完等终端下载完成后再点一次生成

接下来 10 分钟

服务起来后,在页面右上角 Preset 下拉框选anime,用同一个提示词再生成一次:Fooocus 会自动下载 animaPencilXL 模型并重写本地配置。这一步验证预设切换链路完整可用,你也能直接对比写实与动漫两条模型线的风格边界。

【免费下载链接】FooocusFocus on prompting and generating项目地址: https://gitcode.com/GitHub_Trending/fo/Fooocus

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询