# aeron-io/agrona

High Performance data structures and utility methods for Java

Repository: https://github.com/aeron-io/agrona
Canonical: https://ross.abutalabs.com/products/agrona
Language: Java
License: Apache-2.0
License Family: permissive
Topics: java, performance
Last push: 2026-08-20T14:01:11+00:00

## Health v2 (maintenance only)
Score: 94/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 98, release rhythm 86, longevity 100
- inputs: {"age_days": 4321, "days_push": 13, "days_rel": 13, "gap_med": 42, "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 3241, forks 450 (observed 2026-08-28T04:07:50.483819+00:00)

## What it is
Agrona is a Java library of high-performance data structures and utility methods, including primitive-specialized collections, lock-free queues, off-heap buffers, and a timer wheel. It underpins the Aeron messaging transport and Simple Binary Encoding codec.

## Use cases
- avoid boxing overhead with int/long primitive collections in Java
- build low-latency lock-free queues for concurrent services
- work with on-heap and off-heap buffers with memory ordering semantics
- schedule timers with O(1) register and cancel using a timer wheel
- implement IPC communication with ring and broadcast buffers
- generate concurrent unique IDs with a Snowflake-style id generator
- track application telemetry with off-heap counters

## When to choose
- building high-performance or low-latency Java applications
- developing on the JVM where primitive-specialized collections reduce GC pressure
- needing lock-free concurrency utilities or off-heap memory management in Java

## When to avoid
- working outside the JVM ecosystem
- building simple applications where standard Java collections suffice
- needing a general-purpose data structure library with rich APIs rather than performance-focused primitives

## Facets
- artifact type: library
- maturity: active
- function: concurrency, caching, serialization, developer-tools
- domain: performance, developer-tools
- platform: jvm
- tags: data-structures, low-latency, primitive-collections, lock-free, off-heap-memory, ring-buffer, timer-wheel, java, algorithms

## Member repositories
- aeron-io/agrona (main) score 94

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:07:50.483819+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-30T07:24:31.450605+00:00, confidence not recorded.
  - readme: https://github.com/aeron-io/agrona (fetched 2026-08-28T04:07:50.483819+00:00, sha ac6efb3eebc0)
- Data as of 2026-08-30T08:39:29.467469+00:00.