How Jev rates open-source quality: Jev Score rules
- 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.
| Score | Tier | What it looks like |
|---|---|---|
| 100 | Mature and maintained | Updated in the last 6 months, not archived, and clearly in use (many stars) |
| 75 | Clear docs | Can be installed in your own project; the README explains installation and usage |
| 50 | Runnable | The README gives steps to run a demo, example or prototype |
| 25 | Code only | Real Jev-related content, but the README doesn't say how to run or use it |
| 0 | Low relevance | Jev 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
| Score | Raised hands | Subtotal |
|---|---|---|
| 100 · Mature and maintained | 76 | 7,600 |
| 75 · Clear docs | 13 | 975 |
| 50 · Runnable | 2 | 100 |
| 25 · Code only | 5 | 125 |
| 0 · Low relevance | 4 | 0 |
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.