# jbangdev/jbang

Unleash the power of Java - JBang Lets Students, Educators and Professional Developers create, edit and run self-contained source-only Java programs with unprecedented ease.

Repository: https://github.com/jbangdev/jbang
Canonical: https://ross.abutalabs.com/products/jbang
Homepage: https://jbang.dev
Language: Java
License: MIT
License Family: permissive
Topics: scripting, bash, java, shell, hacktoberfest
Last push: 2026-08-23T19:15:13+00:00

## Health v2 (maintenance only)
Score: 97/100 (v2, computed 2026-09-03T02:20:16.233290+00:00)
- activity 99, release rhythm 93, longevity 100
- inputs: {"age_days": 2444, "days_push": 10, "days_rel": 50, "gap_med": 11.0, "n_releases_24m": 37}
- flags: no_readme
- formula: round(0.45*activity + 0.35*rhythm + 0.20*longevity); archived -> min(score, 10)

## Adoption (not part of the score)
Stars 1854, forks 204 (observed 2026-08-28T04:05:44.651068+00:00)

## What it is
JBang is a command-line tool that lets developers create, edit, and run self-contained, source-only Java programs with unprecedented ease, handling dependency fetching and JDK installation automatically. It works across Windows, Linux, macOS, Docker, and CI environments, and integrates with IDEs and build tools like Maven and Gradle.

## Use cases
- run a java script from the command line without setting up a project
- quickly try out a java library with dependencies declared inline
- teach java to students without build tool complexity
- share runnable java scripts via a git-backed catalog
- run java in CI pipelines like GitHub Actions without installing java manually
- prototype java code as easily as writing a bash or python script

## When to choose
- you want to run single-file java programs or scripts without creating a maven/gradle project
- you need automatic dependency resolution from inline annotations in source files
- you want java auto-installed when no JDK is present
- you are teaching or learning java and want minimal setup friction

## When to avoid
- you are building a large multi-module application that needs full build tooling
- you need packaging into distributable jars or native images as a primary workflow
- your team standardizes on IDE-driven maven/gradle builds exclusively

## Facets
- artifact type: cli-tool
- maturity: active
- function: cli, developer-tools, build-tool, package-manager
- domain: developer-tools
- platform: windows, cli, cross-platform
- tags: java, scripting, run-scripts, dependency-management, jshell, single-file-programs, command-line, linux, macos, docker

## Member repositories
- jbangdev/jbang (main) score 97

## Provenance
- Observed fields: from GitHub, fetched 2026-08-28T04:05:44.651068+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:16:48.990308+00:00, confidence not recorded.
  - homepage: https://jbang.dev (fetched 2026-08-29T10:55:47.089820+00:00, sha 5657cca1da42)
  - site_page: https://www.jbang.dev/documentation (fetched 2026-08-29T10:55:47.099098+00:00, sha 111c30b5f609)
- Data as of 2026-08-30T08:39:29.467469+00:00.