X-ray goggles for your TensorFlow CNNs
Reconstruct what your convolutional network sees, layer by layer, then pipe it straight into TensorBoard.

What it does
tf_cnnvis is a diagnostic library for TensorFlow CNNs that reconstructs input images from layer activations and generates DeepDream-style visualizations. It wraps two established techniques—Zeiler & Fergus deconvolution reconstruction and Google’s DeepDream—into callable functions that log results to TensorBoard’s Images tab.
The interesting bit
The library treats layer selection as a bulk operation: pass 'r', 'p', or 'c' to reconstruct from all ReLU, pooling, or convolutional layers at once, rather than hand-picking individual tensors. For DeepDream, you target specific class indices in the classification layer and let the network hallucinate its own confident misinterpretations.
Key highlights
- Three visualization modes: activation maps, deconvolution reconstruction, and DeepDream class maximization
- Bulk layer targeting via string shortcuts (
'r'/'p'/'c') or explicit layer names - Native TensorBoard integration—outputs appear under the Images tab without extra plumbing
- Helper utilities for image normalization and grid layout of filter visualizations
- Requires TensorFlow ≥ 1.8 (the README specifies this explicitly)
Caveats
- Only two visualization techniques implemented; the README notes “so far,” suggesting stalled expansion
- Setup instructions use
sudo pipand reference Python 2-era tooling - Last meaningful activity appears to be 2017; compatibility with modern TensorFlow is untested in the sources
Verdict
Worth a look if you’re maintaining legacy TensorFlow 1.x models and need quick layer-wise sanity checks without building visualizations from scratch. Skip it if you’re on TF 2.x or want interactive, notebook-native exploration—this is a logging utility, not a debugging environment.