# toy/image_optim

Optimize images using multiple utilities

Repository: https://github.com/toy/image_optim
Canonical: https://ross.abutalabs.com/products/image_optim
Homepage: https://github.com/toy/image_optim
Language: Ruby
License: MIT
License Family: permissive
Topics: ruby, image-optimisation, image-optimization
Last push: 2026-08-16T20:43:00+00:00

## Health v2 (maintenance only)
Score: 76/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 35, longevity 100
- inputs: {"age_days": 5354, "days_push": 17, "days_rel": null, "gap_med": null, "n_releases_24m": 0}
- flags: no_releases
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1551, forks 106 (observed 2026-08-28T04:05:02.171639+00:00)

## What it is
A Ruby gem and command line tool that optimizes (losslessly, or optionally lossily) JPEG, PNG, GIF, and SVG images by wrapping external utilities like pngquant, jpegoptim, oxipng, and svgo. It can be used as a CLI, a Ruby library, or via integrations such as pre-commit hooks.

## Use cases
- compress images losslessly before deploying a website
- reduce png and jpeg file sizes in a build pipeline
- optimize images in a ruby project as part of asset preprocessing
- shrink gif and svg files from the command line
- run image optimization as a pre-commit hook
- batch optimize a folder of images

## When to choose
- you work in Ruby or want a scriptable image optimization pipeline
- you want a single tool that orchestrates many well-known image optimizers
- you need both CLI and library usage with fine-grained worker configuration

## When to avoid
- you need a GUI image compressor (use ImageOptim.app instead)
- you are not on a platform where the external utilities are available and cannot use image_optim_pack
- you need heavy image editing or format conversion rather than optimization

## Facets
- artifact type: library
- maturity: stable
- function: image-processing, cli, compression
- domain: image-processing, files, web-development, developer-tools
- platform: cross-platform, cli, ruby
- tags: image-optimization, lossless-compression, jpeg, png, gif, svg, ruby-gem, external-utilities

## Member repositories
- toy/image_optim (main) score 76

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:02.171639+00:00.
- Health v2: computed from the inputs above; adoption is never an input.
- Inferred fields (summary, facets, guidance): AI-extracted, prompt v1, taxonomy v1, on 2026-08-30T04:30:17.631673+00:00, confidence not recorded.
  - readme: https://github.com/toy/image_optim (fetched 2026-08-28T04:05:02.171639+00:00, sha fd04972b32c0)
  - homepage: https://github.com/toy/image_optim (fetched 2026-08-29T11:30:48.642450+00:00, sha 52cc5f70f63a)
- Data as of 2026-08-30T08:39:29.467469+00:00.