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),仅供参考