Quick Install
Get PhotoIDE running in seconds. Choose your preferred method below.
Install via pip
The recommended way. Requires Python 3.8+ and a CUDA-capable GPU for optimal performance (CPU mode also supported).
# Install PhotoIDE
pip install photoide
# Verify installation
photoide --version
# Quick start — enhance a photo
photoide enhance input.jpg --output enhanced.jpg
# Remove background
photoide remove-bg photo.png --output no-bg.png
# Style transfer
photoide style photo.jpg --style starry-night --output artistic.jpg
Install via Docker
Run PhotoIDE in an isolated container with all dependencies pre-installed. Ideal for servers and CI/CD pipelines.
# Pull and run
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
# Build from source
git clone https://github.com/samaidev/photoide.git
cd photoide
docker build -t photoide .
docker run -v ./photos:/data photoide photoide --help
System Requirements
PhotoIDE is designed to run on a wide range of hardware configurations, from consumer laptops to dedicated GPU servers.
Python 3.8+
Requires Python 3.8 or later. Python 3.10+ recommended for best performance and compatibility with all AI models.
GPU (Optional)
NVIDIA GPU with CUDA support recommended for fast inference. CPU mode is available but significantly slower for generative AI features.
RAM
Minimum 4GB RAM for basic operations. 8GB+ recommended for style transfer and generative fill. 16GB+ for batch processing large images.
Disk Space
Approximately 2GB for the base package with built-in models. Additional models are downloaded on first use and cached locally.
Downloads
Standalone binaries for systems where pip install is not convenient. Includes bundled Python runtime and all dependencies.