# Fooocus

**Repository Path**: xingyf666/fooocus

## Basic Information

- **Project Name**: Fooocus
- **Description**: 基于 https://github.com/lllyasviel/Fooocus 的 AI 绘图。
- **Primary Language**: Unknown
- **License**: GPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-15
- **Last Updated**: 2026-04-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Fooocus 本地部署与使用指南

本仓库提供 Fooocus 项目的本地部署方案，包含自动化环境配置、GPU检测和优化的启动流程。

## 项目特色

- 🚀 **一键部署**: 自动化 Python 环境配置和依赖安装
- 🔍 **智能GPU检测**: 自动识别硬件环境并选择最优 PyTorch 版本
- 📦 **离线友好**: 支持完全离线运行，依赖包本地缓存
- 🖼️ **多预设支持**: 提供多种风格预设和中文界面选项

## 快速开始

### 系统要求
- Windows 10/11 或 Linux/macOS
- 至少 8GB RAM（推荐 16GB+）
- NVIDIA GPU（可选，支持 CPU 模式）

### 安装与启动

1. **克隆仓库**:
   ```bash
   git clone https://gitee.com/xingyf666/fooocus.git
   cd fooocus
   ```

2. **启动应用**:
   ```bash
   # Windows：唯一入口，默认 anime 预设 + 中文界面
   run_cn.bat

   # 可追加任意上游 CLI 参数（透传到 entry_with_update.py）
   run_cn.bat --preset realistic
   run_cn.bat --share

   # Linux/macOS：直接调用入口脚本
   python Fooocus/entry_with_update.py --preset anime --language cn
   ```

首次运行会自动：
- 下载 Python 3.10 embeddable 包
- 安装 PyTorch 和其他依赖
- 创建本地运行时环境

## 项目结构

```
fooocus/
├── Fooocus/            # 主程序源码（上游项目）
├── run_cn.bat          # 唯一启动入口（Windows）
├── init_env.ps1        # 环境初始化（GPU 检测 + 依赖安装）
├── test_bootstrap.ps1  # 端到端功能验证
├── test_regression.ps1 # GPU 分支回归测试
├── LICENSE
└── README.md           # 本文档
```

> 运行时生成的 `Fooocus/config.txt` 和 `Fooocus/config_modification_tutorial.txt` 由程序首次启动时自动创建，无需手动提供。

## GPU 智能检测

### 自动检测功能

项目具备先进的 GPU 检测能力：

- **硬件识别**: 自动检测 NVIDIA GPU 和 CUDA 版本
- **版本适配**: 根据 CUDA 版本选择对应 PyTorch
  - CUDA 11.x → PyTorch 2.0.1
  - CUDA 12.x → PyTorch 2.1.0
- **回退机制**: 无 GPU 时自动使用 CPU 版本
- **跨平台支持**: Windows/Linux/macOS 全兼容

### 手动配置覆盖

如需覆盖自动检测结果：

**环境变量**:
```bash
# 强制指定 CUDA 版本
set FORCE_CUDA_VERSION=11.8

# 强制使用 CPU 模式  
set FORCE_CPU_ONLY=1

# 强制指定计算能力
set FORCE_SM_VERSION=sm_89
```

**命令行参数**（透传给 `entry_with_update.py`）:
```bash
run_cn.bat --preset realistic --share
```

## 核心功能

Fooocus 支持以下 AI 图像生成能力：

### 文本生成图像
- 高质量文生图，支持多种风格和分辨率
- 先进的提示词理解和图像合成

### 图像编辑与增强
- **图像变体**: 基于原图生成风格变体
- **超分辨率**: 图像放大和细节增强
- **局部重绘**: 选择性修改图像区域
- **智能扩图**: 扩展图像边界内容

### 人像处理
- **人脸替换**: 身份保持的面部生成
- **人像分割**: 精确的人物区域提取
- **背景融合**: 自然的人物场景融合

## 验证与测试

### 功能验证
```bash
# 运行端到端测试
.\test_bootstrap.ps1

# 测试特定 GPU 模式
.\test_bootstrap.ps1 -ForceGpu cpu
.\test_bootstrap.ps1 -ForceGpu cu118  
.\test_bootstrap.ps1 -ForceGpu cu121
```

测试脚本会验证：
- GPU 检测准确性
- 依赖安装正确性
- 启动流程完整性

## 配置管理

### 配置文件
首次启动后会在 `Fooocus/` 目录下自动生成：
- `Fooocus/config.txt` - 用户配置文件（模型路径、默认参数等）
- `Fooocus/config_modification_tutorial.txt` - 所有可用配置项的参考说明

如需恢复默认配置，直接删除 `Fooocus/config.txt` 后重新启动即可。

### 模型存储
模型默认下载到以下目录：
- `Fooocus/models/checkpoints/` - 主模型
- `Fooocus/models/controlnet/` - 控制网络模型
- `Fooocus/models/inpaint/` - 修复模型
- `Fooocus/models/clip_vision/` - CLIP 视觉模型

## 常见问题

### 安装问题

**Q: PyTorch 安装失败**
A: 自动检测会选择合适的版本，无需手动干预

**Q: GPU 检测不准确**  
A: 使用环境变量强制指定配置

**Q: 中文显示乱码**
A: 终端编码问题，不影响文件实际内容

### 性能优化

**多GPU环境**: 自动选择性能最强的 GPU
**内存不足**: 降低图像分辨率或使用 CPU 模式
**生成速度**: 确保使用 GPU 加速

## 技术支持

- **上游项目**: [Fooocus Official](https://github.com/lllyasviel/Fooocus)
- **问题反馈**: 查看 `Fooocus/readme.md` 获取详细文档

## 许可证

本项目基于 Fooocus 开源项目构建，遵循原项目许可证。

---

*最后更新: 2024年*