[ English | 中文 ]
如果是第一次使用，推荐使用重写后的新项目 FooocusAPI
我还准备了一个迁移指南
如果是从 0.3.x 版本升级到 0.4.0 版本，请务必阅读以下兼容性说明：
- 如果你使用的是外部 Fooocus 模型（即模型不是位于
repositories/Fooocus/models目录下），直接删除repositories目录，然后执行git pull更新即可 - 如果不是上述方式，将
repositories/Fooocus/models目录移动到任意目录，删除repositories目录，然后执行git pull更新，完成后将models目录移动回原位置
使用 FastAPI 构建的 Fooocus 的 API。
当前支持的 Fooocus 版本: 2.3.1。
该章节来自 Fooocus 项目。
Fooocus 是一个图像生成软件 (基于 Gradio)。
Fooocus 是对于 Stable Diffusion 和 Midjourney 的重新思考以及设计：
-
我们学习了 Stable Diffusion 的开源、免费、离线运行。
-
我们学习了 Midjourney 的专注，不需要手动调整，专注于描述词以及图像。
Fooocus 包含了许多内部优化以及质量改进。 忘记那些复杂困难的技术参数，享受人机交互带来的想象力的突破以及探索新的思维
可能您已经尝试过通过 Gradio 客户端 来接入 Fooocus，但您可能发现体验并不理想。
Fooocus API 是基于 FastAPI 构建的一系列 REST 接口，它们使得利用 Fooocus 的强大功能变得简单易行。现在，您可以使用任何您喜欢的编程语言来轻松地与 Fooocus 进行交互。
此外，我们还提供了详尽的 API 文档 和丰富的 示例代码，以帮助您快速上手和深入了解如何有效地利用 Fooocus。
现在你可以在 Replicate 上使用 Fooocus-API，在这儿： konieshadow/fooocus-api.
使用预先调整参数的:
我认为这是更简单的方法来体验 Fooocus 的强大
出于某些原因，上述 replicate 上的实例版本无法更新，你可以参照 push-a-model 部署自己专用的实例。
需要 Python >= 3.10，或者使用 conda、venv 创建一个新的环境
硬件需求来源于 Fooocus。 详细要求可以看这里
按照下面的步骤启动一个 app：
conda env create -f environment.yaml
conda activate fooocus-api然后，执行 python main.py 启动 app ，默认情况下会监听在 http://127.0.0.1:8888
如果是第一次运行，程序会自动处理完成剩余的环境配置、模型下载等工作，因此会等待一段时间。也可以预先配置好环境、下载模型，后面会提到。
和使用 conda 类似，创建虚拟环境，启动 app ，等待程序完成环境安装、模型下载
# windows
python -m venv venv
.\venv\Scripts\Activate# linux
python -m venv venv
source venv/bin/activate然后执行 python main.py
如果想要手动配置环境以及放置模型，可以参考下面的步骤
在创建完 conda 或者 venv 环境之后，按照下面的步骤手动配置环境、下载模型
首先，安装 requirements： pip install -r requirements.txt
然后安装 pytorch+cuda： pip install torch==2.1.0 torchvision==0.16.0 torchaudio==2.1.0 --index-url https://download.pytorch.org/whl/cu121
更多安装信息在 pytorch 官方的 previous-versions 页面找到。
关于 pytorch 和 cuda 的版本，Fooocus API 使用的是 Fooocus 推荐的版本，目前是 pytorch2.1.0+cuda12.1。如果你是个 "犟种" 非要用其他版本，我测试过也是可以的，不过启动的时候记得加上
--skip-pip，否则程序会自动替换为推荐版本。
进入 repositories 的目录，下载的模型放到这个目录 repositories\Fooocus\models。如果你有一个已经安装完成的 Fooocus，在这里查看如何复用模型
这里是一个启动必须下载的模型列表 (也可能不一样如果 启动参数 不同的话):
-
checkpoint: 放到
repositories\Fooocus\models\checkpoints -
vae_approx: 放到
repositories\Fooocus\models\vae_approx -
lora: 放到
repositories\Fooocus\models\loras
国内不好下的到 这儿下载， 提取码:
D4Mk
如果你已经有一个安装好的且运行正常的 Fooocus， 推荐的方式是复用模型, 只需要将 Fooocus 根目录下的 config.txt 文件复制到 Fooocus API 的根目录即可。 查看 Customization 获取更多细节.
使用这种方法 Fooocus 和 Fooocus API 会同时存在，独立运行互不干扰。
不要将已安装的 Fooocus 目录复制到 repositories 目录。
开始之前，先安装 NVIDIA Container Toolkit，这是 Docker 可以使用 GPU 的前提。
运行
docker run -d --gpus=all \
-e NVIDIA_DRIVER_CAPABILITIES=compute,utility \
-e NVIDIA_VISIBLE_DEVICES=all \
-p 8888:8888 konieshadow/fooocus-api一个更实用的例子:
mkdir ~/repositories
mkdir -p ~/.cache/pip
docker run -d --gpus=all \
-e NVIDIA_DRIVER_CAPABILITIES=compute,utility \
-e NVIDIA_VISIBLE_DEVICES=all \
-v ~/repositories:/app/repositories \
-v ~/.cache/pip:/root/.cache/pip \
-p 8888:8888 konieshadow/fooocus-api这里把 repositories 和 pip cache 映射到了本地
你还可以添加 -e PIP_INDEX_URL={pypi-mirror-url} 选项来更换 pip 源
0.4.0.0 版本开始，镜像包含完整运行环境，因此只需要根据需要将
models或者项目根目录进行映射即可 比如：docker run -d --gpus all \ -v /Fooocus-API:/app \ -p 8888:8888 konieshadow/fooocus-api
-h, --help显示本帮助并退出--port PORT设置监听端口，默认：8888--host HOST设置监听地址，默认：127.0.0.1--base-url BASE_URL设置返回结果中的地址，默认是： http://host:port--log-level LOG_LEVELUvicorn 中的日志等级，默认：info--skip-pip跳过启动时的 pip 安装--preload-pipeline启动 http server 之前加载 pipeline--queue-size QUEUE_SIZE工作队列大小，默认是 100 ，超过队列的请求会返回失败--queue-history QUEUE_HISTORY保留的作业历史，默认 0 即无限制，超过会被删除，包括生成的图像--webhook-url WEBHOOK_URL通知生成结果的 webhook 地址，默认为 None--persistent持久化历史记录到SQLite数据库，默认关闭--apikey APIKEY设置 apikey 以启用安全api，默认值：无
从 v0.3.25 开始, Fooocus 的命令行选项也被支持，你可以在启动时加上 Fooocus 支持的选项
比如(需要更大的显存):
python main.py --all-in-fp16 --always-gpu
完成的 Fooocus 命令行选项可以在这儿找到。
更早的日志可以在 release page 找到
你可以在这里找到所有的 API 细节
This repository is licensed under the GUN General Public License v3.0
The default checkpoint is published by RunDiffusion, is licensed under the CreativeML Open RAIL-M.
or, you can find it here
感谢所有为改进 Fooocus API 做出贡献和努力的人。再次感谢 ✨ 社区万岁 ✨!