# fogleman/primitive

Reproducing images with geometric primitives.

Repository: https://github.com/fogleman/primitive
Canonical: https://ross.abutalabs.com/products/primitive
Homepage: https://primitive.lol/
Language: Go
License: MIT
License Family: permissive
Topics: go, graphics, art, primitives
Last push: 2024-07-22T10:53:48+00:00

## Health v2 (maintenance only)
Score: 32/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 0, release rhythm 35, longevity 100
- inputs: {"age_days": 3641, "days_push": 772, "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 13185, forks 649 (observed 2026-08-28T04:11:02.493790+00:00)

## What it is
A Go command-line tool that reproduces images using geometric primitives like triangles, ellipses, and polygons. It iteratively adds shapes that minimize the error between the target image and the drawn result, producing abstract, artistic renditions.

## Use cases
- convert a photo into abstract geometric art
- generate SVG vector art from a PNG image
- create animated GIFs showing shapes being added step by step
- reproduce images with a limited number of shapes
- generate artistic low-poly style renditions of pictures

## When to choose
- you want to stylize images as geometric primitive art from the command line
- you need vector (SVG) or animated (GIF) output of the drawing process
- you want a fast, parallelized Go tool with no heavy dependencies

## When to avoid
- you need general-purpose image editing or photo filters
- you require precise, faithful image reproduction rather than abstract art
- you need a GUI on platforms other than macOS

## Facets
- artifact type: cli-tool
- maturity: maintenance
- function: image-processing, graphics
- domain: graphics, image-processing
- platform: go, cli, cross-platform
- tags: generative-art, geometric-primitives, svg-output, image-recreation, art, macos

## Member repositories
- fogleman/primitive (main) score 32

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:11:02.493790+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-29T17:13:27.488579+00:00, confidence not recorded.
  - readme: https://github.com/fogleman/primitive (fetched 2026-08-28T04:11:02.493790+00:00, sha 870b0d2c9490)
- Data as of 2026-08-30T08:39:29.467469+00:00.