快速安装
几秒内让 PhotoIDE 运行起来。选择下方你偏好的安装方式。
通过 pip 安装
推荐方式。需要 Python 3.8+，建议配备支持 CUDA 的 GPU 以获得最佳性能（也支持 CPU 模式）。
# 安装 PhotoIDE
pip install photoide
# 验证安装
photoide --version
# 快速开始 — 增强照片
photoide enhance input.jpg --output enhanced.jpg
# 移除背景
photoide remove-bg photo.png --output no-bg.png
# 风格迁移
photoide style photo.jpg --style starry-night --output artistic.jpg
通过 Docker 安装
在预装所有依赖的隔离容器中运行 PhotoIDE。适合服务器和 CI/CD 流水线。
# 拉取并运行
docker pull ghcr.io/samaidev/photoide:latest
docker run -v ./photos:/data ghcr.io/samaidev/photoide:latest \
photoide enhance /data/input.jpg --output /data/enhanced.jpg
# 从源码构建
git clone https://github.com/samaidev/photoide.git
cd photoide
docker build -t photoide .
docker run -v ./photos:/data photoide photoide --help
系统要求
PhotoIDE 设计为可在广泛的硬件配置上运行，从消费级笔记本到专用 GPU 服务器。
Python 3.8+
需要 Python 3.8 或更高版本。推荐 Python 3.10+ 以获得最佳性能和所有 AI 模型的完整兼容性。
GPU（可选）
推荐配备 CUDA 支持的 NVIDIA GPU 以实现快速推理。CPU 模式可用，但生成式 AI 功能会明显较慢。
内存
基础操作至少 4GB RAM。风格迁移和生成填充建议 8GB+。批量处理大图像建议 16GB+。
磁盘空间
基础包含内置模型约 2GB。额外模型在首次使用时下载并本地缓存。
下载
适用于不方便使用 pip install 的系统的独立二进制包。包含打包的 Python 运行时和所有依赖。