A super-resolution tool that admits it’s making things up
It upscales photos by hallucinating plausible details, because true HD reconstruction is only possible in Hollywood.

What it does Neural Enhance is a Python command-line utility that upscales images by 2× or 4× using convolutional neural networks. It bundles pre-trained models for general photos and JPEG artifact repair, and can run inference on CPU or GPU. The README claims 1080p output takes about five seconds on a GPU and 20–60 seconds on a CPU, with RAM permitting parallel batches.
The interesting bit The project is admirably honest about its limitations: it labels its output as “Creative AI” and concedes the network is inventing textures based on training data, not recovering the original high-resolution signal. That transparency sets it apart from tools that imply exact reconstruction. The approach stitches together perceptual loss and adversarial techniques from a stack of 2016 super-resolution papers.
Key highlights
- Pre-trained models for 2× upscaling and 1× JPEG repair are provided in GitHub releases; a specialized face model trained on celebrity portraits reportedly yields much better results for narrow domains.
- Custom training is supported using perceptual and adversarial loss, though the README warns it is a “delicate process” requiring careful parameter choices.
- GPU inference is fast enough for interactive use, while CPU mode can run 4–8 processes in parallel if system memory allows.
- A Docker image is available, sidestepping the brittle manual dependency chain of Python 3.4+, Theano, Lasagne, and an external 80 MB VGG19 weights file.
Caveats
- The supported-model table is sparse: only
--type=photohas entries, and the denoise and deblur columns are empty ellipses. - The troubleshooting section is long for a reason—expect potential Cython, BLAS, and Theano/Lasagne version-mismatch headaches, especially on manual installs.
- Training your own model requires downloading the VGG19 weights separately and tuning hyperparameters without much guard-rails.
Verdict A fun, self-aware experiment in generative upscaling if you can tolerate its finicky dependency stack. Look elsewhere for maintained, production-ready restoration pipelines.
Frequently asked
- What is alexjc/neural-enhance?
- It upscales photos by hallucinating plausible details, because true HD reconstruction is only possible in Hollywood.
- Is neural-enhance open source?
- Yes — alexjc/neural-enhance is open source, released under the AGPL-3.0 license.
- What language is neural-enhance written in?
- alexjc/neural-enhance is primarily written in Python.
- How popular is neural-enhance?
- alexjc/neural-enhance has 11.9k stars on GitHub.
- Where can I find neural-enhance?
- alexjc/neural-enhance is on GitHub at https://github.com/alexjc/neural-enhance.