# Phlya/adjustText

A small library for automatical adjustment of text position in matplotlib plots to minimize overlaps.

Repository: https://github.com/Phlya/adjustText
Canonical: https://ross.abutalabs.com/products/adjusttext
Homepage: https://adjusttext.readthedocs.io/
Language: Jupyter Notebook
License: MIT
License Family: permissive
Topics: graph, matplotlib, plot, plotting, text, python
Last push: 2026-06-08T16:47:54+00:00

## Health v2 (maintenance only)
Score: 78/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 86, release rhythm 55, longevity 100
- inputs: {"age_days": 3889, "days_push": 86, "days_rel": 86, "gap_med": 585, "n_releases_24m": 2}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1661, forks 96 (observed 2026-08-28T04:05:18.518849+00:00)

## What it is
adjustText is a small Python library that automatically adjusts the position of text labels in matplotlib plots to minimize overlaps between labels and data points. It iteratively repositions labels and is inspired by the ggrepel package for R/ggplot2.

## Use cases
- label scatter plot points without overlapping text in matplotlib
- automatically reposition annotations on crowded plots
- avoid manual tweaking of text label positions in figures
- create publication-quality labeled charts for scientific papers
- replicate ggrepel-style label placement in Python

## When to choose
- you use matplotlib and need many text labels placed without overlaps
- you want a simple pip-installable solution with good default results
- you need configurable iterative label adjustment for complex plots

## When to avoid
- you are plotting with libraries other than matplotlib
- you need interactive drag-and-drop label placement
- you work primarily in R, where ggrepel is the native solution

## Facets
- artifact type: library
- maturity: stable
- function: data-visualization
- domain: data-visualization, data-science
- platform: python
- tags: matplotlib, label-placement, plotting, text-overlap

## Member repositories
- Phlya/adjustText (main) score 78

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:18.518849+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-30T03:44:36.485443+00:00, confidence not recorded.
  - readme: https://github.com/Phlya/adjustText (fetched 2026-08-28T04:05:18.518849+00:00, sha 9210b80024ae)
  - registry_pypi: https://pypi.org/pypi/adjusttext/json (fetched 2026-08-29T11:17:25.200274+00:00, sha 28220ea440fc)
- Data as of 2026-08-30T08:39:29.467469+00:00.