How Jev rates open-source quality: Jev Score rules

Rules updated Oct 14 · Applies to the Jev open-source ranking

This page
Explains how the “quality” score (0–100) on the Jev open-source ranking is produced.
Solves
Popular doesn't mean usable. The quality score helps you tell, before you start, whether a repository is a mature project you can use directly or an experiment with a few lines of code.
For
People picking a Jev tool to use right away, and authors who want to know how to improve their project's score.

How scoring works

Jev (TypeSafe AI's decision model) reads the repository's description, README, topics, stars and last update, decides which of the 5 tiers below it falls in and gives each tier a probability. The tiers form a ladder: each one adds a single requirement to the one below. Treat the probabilities as “100 people raising hands” and average by headcount; the maximum is 100.

ScoreTierWhat it looks like
100Mature and maintainedUpdated in the last 6 months, not archived, and clearly in use (many stars)
75Clear docsCan be installed in your own project; the README explains installation and usage
50RunnableThe README gives steps to run a demo, example or prototype
25Code onlyReal Jev-related content, but the README doesn't say how to run or use it
0Low relevanceJev is only mentioned in passing, or there is no real content yet

Resource-list repositories (awesome lists) are rated on curation, not code: scattered links 25, organized into sections 50, each entry explained 75, kept up to date and widely starred 100.

Worked example

quantdinger

ScoreRaised handsSubtotal
100 · Mature and maintained767,600
75 · Clear docs13975
50 · Runnable2100
25 · Code only5125
0 · Low relevance40

Average88

FAQ

How often is a repository rated?
Once when it is first included; all repositories are re-rated together when the scoring rules change.
How do I raise my project's quality score?
Write a clear README: what it does, how to install it and how to run it. Add examples and topics, and keep it updated.
What if the score looks wrong?
Email hello@jev-x.com with the repository URL and we will review it manually.