4o-ghibli-at-home：本地运行的Ghibli风格图像转换工具

4o-ghibli-at-home 是一个开源的AI图像风格转换工具，专注于将用户上传的图像转换为Studio Ghibli风格的艺术作品。它使用FLUX.1-Kontext-dev和DFloat11模型，运行在本地设备上，确保数据隐私。用户无需登录或依赖云服务，图像处理全程在本地完成。目前仅支持Linux系统，适用于移动设备和桌面设备，未来计划支持Windows。该工具适合喜欢Ghibli风格的创作者或动漫爱好者，能快速将普通照片转化为具有柔和色彩和手绘质感的艺术图像。项目采用AGPLv3许可证，允许个人和研究用途免费使用。

功能列表

• 将普通图像转换为Studio Ghibli风格的艺术图像，支持动漫、艺术或自定义风格。
• 使用FLUX.1-Kontext-dev和DFloat11模型，提供高效的图像处理能力。
• 支持本地运行，保护用户隐私，图像数据不上传云端。
• 提供简单易用的命令行界面，适合技术用户操作。
• 支持在Linux系统上运行，兼容移动设备和桌面设备。
• 允许用户通过配置文件调整图像处理参数，满足个性化需求。
• 开源项目，代码公开，允许用户修改和优化。

使用帮助

安装流程

要使用4o-ghibli-at-home，用户需要在Linux系统上完成安装。以下是详细步骤：

1. 克隆项目代码
   打开终端，输入以下命令克隆项目到本地：

   git clone https://github.com/TheAhmadOsman/4o-ghibli-at-home.git
   cd 4o-ghibli-at-home
   

2. 创建虚拟环境
   项目推荐使用 uv 工具管理Python虚拟环境。如果未安装 uv，请先安装：

   curl -LsSf https://astral.sh/uv/install.sh | sh
   

   安装后，可能需要重启终端以确保 uv 命令生效。接着，创建虚拟环境：

   uv venv .venv --python 3.12
   source .venv/bin/activate
   

3. 安装依赖
   在虚拟环境中，同步项目所需的Python依赖：

   uv sync
   

4. 配置环境变量
   项目需要Hugging Face的访问令牌来下载模型。复制模板文件并配置：

   cp .env_template .env
   

   使用文本编辑器打开 .env 文件，填入Hugging Face的访问令牌（在Hugging Face账户设置中生成）。示例：

   HUGGING_FACE_HUB_TOKEN=your_token_here
   

   如果已通过 huggingface-cli login 登录，则无需手动设置令牌。

5. 启动服务
   配置完成后，启动项目服务：

   python3.12 app.py
   

   服务启动后，项目会运行一个本地Web服务器和后台处理进程，用于图像风格转换。

使用方法

启动服务后，用户可以通过命令行或Web界面上传图像。以下是具体操作：

1. 准备图像
   确保有需要转换风格的图像文件（如JPG或PNG格式）。推荐使用清晰度较高的图像以获得最佳效果。
2. 上传图像
   项目运行后，访问本地Web界面（通常为 http://localhost:5000，具体端口以启动时的提示为准）。在界面中选择图像文件，点击上传。
3. 选择风格
   界面提供Ghibli风格、动漫风格或其他自定义风格选项。用户可根据需要选择，默认推荐Ghibli风格，模仿《龙猫》或《千与千寻》的柔和手绘效果。
4. 调整参数
   在 .env 文件或Web界面中，用户可以调整图像处理参数，如分辨率、色彩饱和度或细节程度。初次使用可保持默认设置。
5. 生成图像
   上传图像并选择风格后，点击“生成”按钮。处理时间取决于设备性能和图像大小，通常需要几秒到几分钟。生成结果会显示在界面上，用户可下载转换后的图像。

特色功能操作

• Ghibli风格转换：核心功能是将照片转为Ghibli风格图像。用户上传风景或人物照片后，工具会自动应用柔和的色彩、细腻的纹理和动漫化的背景，生成类似Studio Ghibli电影的画面。
• 隐私保护：所有处理都在本地完成，图像不会上传到云端，适合对数据隐私敏感的用户。
• 自定义风格：用户可以通过修改配置文件或代码，扩展支持其他艺术风格，如漫画或水彩画。
• 高效处理：FLUX.1模型优化了VRAM使用，适合中低配设备运行，生成速度较快。

注意事项

• 确保设备有足够的存储空间（模型文件较大，可能需要数GB）。
• 首次运行需要下载模型，可能耗时较长，建议保持网络稳定。
• 如果遇到模型下载失败，请检查Hugging Face令牌是否正确。
• 项目目前仅支持Linux，Windows用户需等待后续更新。

应用场景

1. 个人艺术创作
   动漫爱好者可以将日常照片（如自拍或风景）转换为Ghibli风格的艺术作品，用于社交媒体分享或个人收藏。
2. 设计素材制作
   插画师或平面设计师可以使用该工具快速生成Ghibli风格的图像，作为海报、壁纸或概念艺术的素材。
3. 教育与研究
   AI研究人员可以利用开源代码研究图像风格转换技术，探索FLUX.1模型的应用场景。
4. 粉丝社区项目
   Studio Ghibli粉丝可以用该工具为同人作品生成图像，制作漫画、壁纸或周边设计。

QA

1. 这个工具是免费的吗？
   是的，4o-ghibli-at-home 是开源项目，遵循AGPLv3许可证，个人和研究用途免费。如果用于商业用途，需遵守许可证要求，公开修改后的源代码。
2. 需要强大的硬件支持吗？
   不需要顶级硬件，但建议至少有8GB内存和4GB显存的GPU以获得流畅体验。FLUX.1模型已优化VRAM使用，适合中低配设备。
3. 支持哪些图像格式？
   支持常见格式如JPG、PNG。推荐使用高分辨率图像以获得更好的转换效果。
4. 如何解决模型下载失败？
   检查 .env 文件中的Hugging Face令牌是否正确，或使用 huggingface-cli login 登录。如果网络不稳定，可尝试更换网络或稍后重试。
5. 可以转换视频吗？
   当前版本仅支持静态图像转换。视频支持可能在未来更新中添加。