# lysine-dev/retrofit

A type-safe HTTP client for Android and the JVM

Repository: https://github.com/lysine-dev/retrofit
Canonical: https://ross.abutalabs.com/products/retrofit
Homepage: https://lysine.dev/retrofit/
Language: Java
License: Apache-2.0
License Family: permissive
Topics: java, android
Last push: 2026-08-26T13:56:16+00:00

## Health v2 (maintenance only)
Score: 79/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 40, longevity 100
- inputs: {"age_days": 5840, "days_push": 7, "days_rel": 475, "gap_med": 0, "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 43934, forks 7340 (observed 2026-08-28T04:12:09.183800+00:00)

## What it is
Retrofit is a type-safe HTTP client for Android and the JVM that turns REST APIs into Java or Kotlin interfaces using annotations. It generates implementations of these interfaces and supports synchronous and asynchronous requests, converters, and multipart uploads.

## Use cases
- consume a REST API from an Android app
- turn an HTTP API into a typed Java interface
- make type-safe network requests on the JVM
- upload files via multipart requests
- deserialize JSON API responses into Java objects
- call remote web services with declarative annotations

## When to choose
- you are building an Android or JVM app that talks to a REST API
- you want declarative, annotation-based HTTP clients instead of manual request code
- you need mature, widely adopted networking tooling with converter and adapter ecosystems

## When to avoid
- you need a non-HTTP protocol like raw TCP or WebSockets
- you are not on the JVM or Android platform
- you want a fully dynamic HTTP client without interface definitions

## Facets
- artifact type: library
- maturity: stable
- function: http-client, serialization, middleware
- domain: web-development, mobile-development, apis, backend
- platform: jvm, cross-platform
- tags: rest-client, declarative-http, okhttp, kotlin-support, annotations, android

## Member repositories
- lysine-dev/retrofit (main) score 79

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:12:09.183800+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-29T16:22:16.169601+00:00, confidence not recorded.
  - readme: https://github.com/lysine-dev/retrofit (fetched 2026-08-28T04:12:09.183800+00:00, sha e4175f8a3306)
  - homepage: https://lysine.dev/retrofit/ (fetched 2026-08-29T07:45:59.773312+00:00, sha 29b7c0fb9f87)
- Data as of 2026-08-30T08:39:29.467469+00:00.