# google/go-containerregistry

Go library and CLIs for working with container registries

Repository: https://github.com/google/go-containerregistry
Canonical: https://ross.abutalabs.com/products/go-containerregistry
Language: Go
License: Apache-2.0
License Family: permissive
Topics: docker, container, registry, container-registry
Last push: 2026-08-26T02:37:48+00:00

## Health v2 (maintenance only)
Score: 99/100 (v2, computed 2026-09-03T02:39:23.370411+00:00)
- activity 99, release rhythm 99, longevity 100
- inputs: {"age_days": 3094, "days_push": 8, "days_rel": 8, "gap_med": 19, "n_releases_24m": 16}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 4026, forks 673 (observed 2026-08-28T04:08:32.617950+00:00)

## What it is
A Go library and set of CLI tools (like crane) for interacting with OCI container registries and images. It provides immutable views of images, layers, and indexes backed by registries, tarballs, daemons, or OCI layouts, with composable mutation primitives.

## Use cases
- pull and push docker images to a container registry programmatically
- inspect image manifests and layers from a registry
- build and append images to an OCI layout on disk
- copy or retag container images between registries
- manipulate image layers and configs without a docker daemon
- extract image tarballs and convert between formats

## When to choose
- you need to work with OCI images or registries from Go code
- you want daemonless container image operations
- you're building tooling that reads, writes, or mutates container images

## When to avoid
- you need a full container runtime to execute containers
- you want a GUI for managing docker images
- you're working with non-OCI legacy image formats exclusively

## Facets
- artifact type: library
- maturity: active
- function: developer-tools, container-runtime, cli, http-client
- domain: developer-tools, cloud-computing
- platform: go, cross-platform, cli
- tags: oci, docker, container-registry, image-manipulation, crane, ko, containers

## Member repositories
- google/go-containerregistry (main) score 99

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:08:32.617950+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-29T18:23:53.712100+00:00, confidence not recorded.
  - readme: https://github.com/google/go-containerregistry (fetched 2026-08-28T04:08:32.617950+00:00, sha 1115eaee60b4)
- Data as of 2026-08-30T08:39:29.467469+00:00.