← all repositories
alexjc/neural-enhance

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.

neural-enhance
Not currently ranked — collecting fresh signals.
star history

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=photo has 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.

heatdrop uses Google Analytics to see which pages get read — nothing else. Your call. How we handle data.