# hub4j/github-api

Java API for GitHub

Repository: https://github.com/hub4j/github-api
Canonical: https://ross.abutalabs.com/products/github-api
Homepage: https://hub4j.github.io/github-api/
Language: Java
License: MIT
License Family: permissive
Topics: java, github, github-api, github-api-v3, java-api, api, client-library
Last push: 2026-08-01T02:08:49+00:00

## Health v2 (maintenance only)
Score: 95/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 95, release rhythm 92, longevity 100
- inputs: {"age_days": 5980, "days_push": 33, "days_rel": 53, "gap_med": 20.5, "n_releases_24m": 15}
- flags: none
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1259, forks 776 (observed 2026-08-28T04:04:09.781026+00:00)

## What it is
A Java library providing an object-oriented representation of the GitHub API, with classes like GHUser and GHRepository mapping to GitHub's domain model. It supports github.com and GitHub Enterprise, with multiple authentication mechanisms including OAuth tokens, JWT, and GitHub App flows.

## Use cases
- manage github repositories from java
- automate github workflows with a java api
- create github apps with jwt authentication in java
- query github users and organizations programmatically
- integrate github into a jvm-based ci tool
- add collaborators to repos via api

## When to choose
- you need a typed, object-oriented Java client for most GitHub REST APIs
- you must support both github.com and GitHub Enterprise
- you need GitHub App authentication flows (JWT, installation tokens) in Java

## When to avoid
- you need a client in a non-JVM language
- you only need simple raw HTTP calls and prefer a lightweight REST client
- you require every corner of the GitHub API, as some endpoints are not yet implemented

## Facets
- artifact type: library
- maturity: active
- function: http-client, auth, sdk
- domain: apis, developer-tools
- platform: jvm, cross-platform
- tags: github-api, client-library, github-enterprise, object-oriented-api, rest-client, automation

## Member repositories
- hub4j/github-api (main) score 95

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:04:09.781026+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-30T05:05:30.509926+00:00, confidence not recorded.
  - readme: https://github.com/hub4j/github-api (fetched 2026-08-28T04:04:09.781026+00:00, sha b45f9d5c47d6)
  - homepage: https://hub4j.github.io/github-api/ (fetched 2026-08-29T12:16:59.851463+00:00, sha 871132b7f948)
- Data as of 2026-08-30T08:39:29.467469+00:00.