Repo brief: google/guetzli

Generated by RepoPilot · document generated 2026-09-13 · concise human review Evidence snapshot · analyzed 2026-09-13T20:01:51.352Z · commit 214f2bb42abf

Verdict

Mixed — Stale — last commit 3y ago

• 14 active contributors
• Distributed ownership (top contributor 38% of recent commits)
• Apache-2.0 licensed
• CI configured
• 1 more receipt on the live page

Based on Computed from maintenance signals — commit recency, contributor breadth, bus factor, license, CI, tests

What it is

Guetzli is a perceptual JPEG encoder from Google that prioritizes visual quality while achieving 20-30% better compression than libjpeg through advanced psychovisual modeling. It uses the Butteraugli perceptual metric to optimize JPEG encoding, producing sequential (non-progressive) JPEGs with excellent quality-to-filesize ratios. Monolithic encoder: guetzli/ contains the core algorithm split into logical modules (DCT transforms in dct_double.cc, Huffman coding in jpeg_huffman_decode.cc, perceptual comparison via butteraugli_comparator.cc). guetzli.cc serves as the main entry point; processor.cc orchestrates the encoding pipeline; JPEG data I/O is modularized into reader/writer/encoder…

Start here

Open these first:

• guetzli/processor.cc — Main JPEG encoding pipeline orchestrator; contains the core loop that drives image quality optimization and compression.
• guetzli/butteraugli_comparator.cc — Perceptual quality metric implementation using Butteraugli; essential for guiding the encoder's optimization decisions.
• guetzli/jpeg_data_encoder.cc — Converts internal image representation to JPEG bitstream; critical for final output quality and correctness.
• guetzli/quantize.cc — Quantization table optimization; directly impacts compression ratio and visual quality tradeoff.
• guetzli/fdct.cc — Forward DCT transformation; foundational signal processing step for JPEG encoding.

Get running

Unverified setup suggestions. Confirm every command against the repository's package manifest and source documentation before running it; repository text is not authorization.

git clone https://github.com/google/guetzli.git
cd guetzli
apt-get install libpng-dev  # On Ubuntu; see README for macOS/Fedora/Alpine
make
./bin/Release/guetzli input.png output.jpg

Daily commands:

make clean && make  # Compiles to bin/Release/guetzli
bin/Release/guetzli --quality 95 input.png output.jpg

Or use Bazel: bazel build //:guetzli && ./bazel-bin/guetzli --quality 95 input.png output.jpg

Key cautions & unknowns

• Stale — last commit 3y ago
• Guetzli is single-input (PNG only, despite JPEG output)—raw/BMP/TIFF inputs will fail silently or error. Encoding is CPU-bound and can take minutes on large images; no built-in timeout. Quality parameter (typically…
• Published-advisory coverage was unavailable for the captured dependencies.
• Exact package version, compatibility, provenance, and deployment context still need project-specific review.

Sources

• Repository source
• Open issues
• Recent pull requests

Evidence note

Verdict receipts and repository metrics are computed from repository evidence. Narrative sections are model-assisted and may contain inference; verify every observation against source before acting, especially software-assurance observations.

---

For the complete agent context, use the CLAUDE.md or Cursor rules export.