# line/armeria

Your go-to microservice framework for any situation, from the creator of Netty et al. You can build any type of microservice leveraging your favorite technologies,  including gRPC, Thrift, Kotlin, Retrofit, Reactive Streams, Spring Boot and Dropwizard.

Repository: https://github.com/line/armeria
Canonical: https://ross.abutalabs.com/products/armeria
Homepage: https://armeria.dev
Language: Java
License: Apache-2.0
License Family: permissive
Topics: http, http2, http-server, http-client, thrift, thrift-server, thrift-client, microservices, grpc, rpc, rpc-framework, rpc-library, rpc-server, rpc-client, micro-framework, grpc-client, grpc-server, netty, gateway, hacktoberfest
Last push: 2026-08-25T07:59:29+00:00

## Health v2 (maintenance only)
Score: 98/100 (v2, computed 2026-09-02T17:46:02.011165+00:00)
- activity 99, release rhythm 96, longevity 100
- inputs: {"age_days": 3943, "days_push": 8, "days_rel": 26, "gap_med": 13, "n_releases_24m": 34}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 5133, forks 1013 (observed 2026-08-28T04:09:11.042144+00:00)

## What it is
Armeria is a JVM microservice framework built on Netty that lets you serve gRPC, Thrift, REST, and static files on a single port. It provides built-in client-side load balancing, circuit breaking, service discovery, distributed tracing, and a web-based RPC debug console.

## Use cases
- build reactive microservices in Java or Kotlin
- serve gRPC and Thrift services alongside REST on one port
- add client-side load balancing and circuit breaking to RPC calls
- migrate between RPC protocols without proxies or sidecars
- debug and invoke RPC endpoints from a browser
- integrate microservices with Spring Boot or Dropwizard

## When to choose
- you need a high-performance async JVM framework supporting multiple RPC protocols
- you want gRPC, Thrift, and HTTP services co-hosted on a single port
- you need built-in service discovery, retries, and circuit breakers
- you want a web console for invoking and sharing RPC calls

## When to avoid
- you are not on the JVM
- you need a minimal single-protocol REST framework with a larger ecosystem
- your team relies on non-Netty server runtimes like standard servlet containers

## Facets
- artifact type: framework
- maturity: stable
- function: web-framework, rpc, http-server, http-client, middleware, api-framework
- domain: backend, microservices, web-development, apis
- platform: jvm, cross-platform
- tags: grpc, thrift, netty, reactive-streams, spring-boot, service-discovery, circuit-breaker, http2, microservices

## Member repositories
- line/armeria (main) score 98

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:09:11.042144+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:02:01.917000+00:00, confidence not recorded.
  - readme: https://github.com/line/armeria (fetched 2026-08-28T04:09:11.042144+00:00, sha 94c746d4916f)
  - homepage: https://armeria.dev (fetched 2026-08-29T08:56:31.551402+00:00, sha b86c5f8e454a)
  - site_page: https://armeria.dev/docs (fetched 2026-08-29T08:56:31.554187+00:00, sha 818030ecce4d)
- Data as of 2026-08-30T08:39:29.467469+00:00.