AiBOX.im

Fooocus

极简 AI 绘图(一键启动,比 A1111 更省心)

— views · — installs
WindowsmacOS 难度 ●●●●○ stable v2.5.5
Fooocus icon

Fooocus · 图标来自 registry

系统要求

无需额外运行时

这个应用自带运行环境——不用另装 Node.js、Python 或其它依赖。

支持平台

WindowsmacOS

极简 AI 绘图(一键启动,比 A1111 更省心)

registry 数据更新于: 2026-11-16

配置与数据

配置文件写到

~/SillyTavern/data/default-user/settings.json

  • ~/Fooocus
  • ~/Fooocus

数据全部留在你自己电脑上,不上传任何地方。卸载 = 删掉这些文件夹。

三步装好

  1. 01

    装上 AiBOX

    Windows 一个便携文件(macOS 版在路上)。双击就跑——不用安装、不要管理员权限。

    去下载 →
  2. 02

    选中 Fooocus

    打开 AiBOX 应用目录,找到 Fooocus 点安装。AiBOX 先检查你机器上已有什么,只补缺的。

  3. 03

    跟着向导点

    自动下载并校验、写配置文件,需要 key 时帮你填好。你只管点下一步。

    ✓ 装到能用为止。

想自己手动装?完整文字教程就在下面。 看教程 ↓

安装教程

同样步骤的文字版——按自己的节奏来。

一句话:Fooocus 是「一键出图」的 AI 绘图工具——学 Midjourney 的省心、学 Stable Diffusion 的免费离线:不用研究参数,写句话就能出好图,4GB 显存起步。

你将得到

  • 极简出图:官方目标是「从点下载到第一张图,鼠标点击少于 3 次」,提示词写得糙也能出好图(内置 GPT-2 提示词自动扩写)
  • 完全离线、开源免费:模型下到本地后断网可用,数据不出机器
  • 需要精细控制时也有:风格包、预设、图生图 / 重绘 / 放大 / 面部替换、SDXL 模型与 LoRA 兼容 Civitai

和 A1111 怎么选(先看这段)

你想要选谁
打开就出图、不想学任何参数Fooocus(本页)
要装插件(ControlNet 等)、逐参数微调、批量自动化Stable Diffusion WebUI(A1111)
模型 / 提示词语法两者通用:Fooocus 采用 A1111 的权重算法,(word:1.5)、embedding 写法照搬可用

准备(3 分钟)

需要说明
Windows 10/11 或 macOS 12+Linux 亦可;全程免管理员
Git + Python 3.10官方要求 Python 3.10(源码路线);Windows 也有免 Python 的官方一键包
显卡最低 4GB 显存 NVIDIA + 8GB 内存(GTX 10 系以下不支持);AMD 走 DirectML 慢约 3 倍,Mac/纯 CPU 更慢
磁盘首次启动自动下载 PyTorch ~2.5GB + SDXL 模型数 GB,预留 20GB+

安装

路线 A:用 AiBOX 安装(推荐)

  1. 打开 AiBOX → 应用目录 → Fooocus → 点「安装」
  2. 下载官方 tag 源码包(哈希校验,国内自动走代理通道)→ 克隆到 ~/Fooocus
  3. 自动创建用户级 venv 并安装 requirements_versions.txt 依赖——不需要管理员、不碰系统 Python

路线 B:手动安装(官方命令)

git clone --depth 1 -b v2.5.5 https://github.com/lllyasviel/Fooocus.git ~/Fooocus
cd ~/Fooocus
python -m venv venv
./venv/bin/pip install -r requirements_versions.txt    # Windows: .\venv\Scripts\pip
./venv/bin/python entry_point.py                      # 官方 Windows 包则是双击 run.bat

首次启动会自动下载模型到 Fooocus/models/checkpoints(可提前手动放好跳过等待)。

配置与验证

生成参数入门(会这五个就够用)

  1. Performance:Speed(30 步,默认)/ Quality(60 步,更细)/ Extreme Speed、Lightning(8 或 4 步,出图飞快,配专用 LoRA)——先用 Speed,赶时间换 Extreme Speed,追质量换 Quality
  2. Style:勾选风格模板(sdxl_styles 目录),推荐默认勾着 Fooocus V2(提示词自动扩写);负向效果用 Advanced → Negative Prompt
  3. Aspect Ratios:出图比例;Image Number:一次出几张;Guidance / Sharpness:Advanced → Advanced 里调,越低越"听话"、越高越有风格
  4. 提示词权重:与 A1111 一致——(sunset:1.4) 强调、--no 想法写进 Negative Prompt
  5. Input Image:拖图进去可用 Upscale / Variation / Inpaint / Outpaint / Image Prompt(含 FaceSwap)

预设与模型(风格包)

  • 顶部可切 preset:default(通用,juggernautXL_v8Rundiffusion)、realistic(写实,realisticStockPhoto_v20)、anime(动漫,animaPencilXL_v500)——切 preset 会自动补下对应模型(想避免自动下载加 --disable-preset-download,并手动把模型放进 models/checkpoints)
  • 命令行指定:--preset anime;自备模型(含 Civitai 的 SDXL 模型、LoRA)直接丢进 models/checkpoints / models/loras 后在 UI 里选

离线模式

模型与依赖下载完后,Fooocus 本身就是离线软件(不联网也能出图)。网络不畅时:加 --hf-mirror https://hf-mirror.com 换国内镜像下模型;完全不想让它联网下载就加 --disable-preset-download。注意首次用 Inpaint 还会下 1.28GB 的专用模型,最好提前跑一次。

./venv/bin/python entry_point.py --preset realistic --port 7860

其他常用参数:--listen(局域网访问)、--language(界面语言)、--theme dark。

怎样算成功

  1. 终端给出 http://127.0.0.1:7860,浏览器打开
  2. 随便写句提示词(如「一只在花园里的猫」)点 Generate
  3. 几秒到几十秒出图,且点开图片能看到生成信息 = 安装成功

常见问题

  • 首次启动特别慢:正常,正在下 PyTorch 和模型;进度看终端输出
  • 报 MetadataIncompleteBuffer / PytorchStreamReader:模型文件损坏,删掉重新下载
  • 显存不够 / RuntimeError: CPUAllocator:确认达到 4GB 显存 + 8GB 内存;Windows 需开启虚拟内存(页面文件),报错页面各盘留 40GB+ 可用空间
  • 出图忽快忽慢:部分 NVIDIA 驱动(532 之后)有 10 变慢的报告,官方建议换回 531 版驱动再试
  • 模型下载被墙 / 太慢:用 --hf-mirror 镜像,或手动下载模型放进 models/checkpoints
  • 端口被占:--port 7861 换端口

卸载

rm -rf ~/Fooocus    # 模型、LoRA、生成图都在里面,删前先备份 models/ 和 outputs/

AiBOX「管理 → 卸载」可代劳。

更多:GitHub README · 常见问题 · 更新日志

模型 / API key 配置

用 AiBOX 安装时向导会自动填好——这一节给想手动配置的人。

OpenRouter

需要服务商的 API key。

~/SillyTavern/data/default-user/settings.json

去拿 key ↗

Anthropic(Claude)

需要服务商的 API key。

~/SillyTavern/data/default-user/settings.json

去拿 key ↗

OpenAI

需要服务商的 API key。

~/SillyTavern/data/default-user/settings.json

去拿 key ↗

Google AI Studio

需要服务商的 API key。

~/SillyTavern/data/default-user/settings.json

去拿 key ↗

Claude 订阅号

用账号登录即可,不用复制 key。

~/SillyTavern/data/default-user/settings.json

去拿 key ↗

Ollama(本地)

本地模型,无需 API key。

~/SillyTavern/data/default-user/settings.json

常见问题

Fooocus 支持哪些平台?

Windows / macOS 都能装——在对应系统上用 AiBOX 一键安装。

Fooocus 难装吗?

难度 4 / 5。下载和配置都由 AiBOX 完成,你只要点向导、需要 key 时粘贴一下。

Fooocus 的数据存在哪?

全部留在你自己电脑上:~/Fooocus / ~/Fooocus。卸载就是删掉这些,不会上传任何东西。

出问题了怎么办?

步骤过时、报错看不懂、错别字——告诉我们,这一页马上修。

反馈问题 →

版本与更新

当前版本
v2.5.5
registry 数据更新于
2026-11-16

版本号由每日探活重新核对——上游发新版,这一页跟着更新。

有问题?

步骤不对、报错看不懂、错别字——开个 issue,有人看。