git404hub

what is fineness fr?

aliihsanto/fineness — explained in plain English

Analysis updated 2026-05-18

0TypeScriptAudience · generalComplexity · 4/5LicenseSetup · hard

tl;dr

Fineness scores GitHub repos behind crypto tokens from 0 to 100 to reveal hidden forks, fake activity, and rug pull risk.

vibe map

mindmap
  root((fineness))
    What it does
      Scores token repos
      Detects hidden forks
      Flags rug risk
    Tech stack
      TypeScript
      Next.js
      Postgres and Redis
    Use cases
      Vet a token before buying
      Compare valuation to activity
      Query the public API
    Audience
      Crypto investors
      Token project owners
    Setup
      pnpm monorepo
      Docker compose
      GitHub token pool

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Check the fineness score of a GitHub repo behind a crypto token before investing.

VIBE 2

See if a token's repo is a hidden fork of another project.

VIBE 3

Compare a token's market value against its actual development activity via the reality gap metric.

VIBE 4

Query the free public API to build your own dashboard using fineness scores.

what's the stack?

TypeScriptNext.jsPostgresRedisBullMQ

how it stacks up fr

aliihsanto/fineness0xradioac7iv/tempfs7vignesh/pgpulse
Stars000
LanguageTypeScriptTypeScriptTypeScript
Setup difficultyhardmoderatemoderate
Complexity4/53/54/5
Audiencegeneraldeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · hard time til it works · 1h+

Self-hosting needs Postgres, Redis, Docker, and a pool of GitHub tokens configured in .env.

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

in plain english

Fineness is a tool that checks GitHub repositories connected to cryptocurrency tokens and scores how genuine the underlying code looks. Many crypto projects launch a token alongside a GitHub repository to suggest real development work is happening, but the repository itself might be a copy of someone else's project, filled with low effort commits, or effectively abandoned. Fineness tries to catch that by producing a public score from zero to one hundred for any repository tied to a token. The score is built from several signals that anyone could check themselves if they had the time. It looks for whether a repository is secretly a fork of another project, checks how contributions are spread across different people, watches whether commit activity has a natural rhythm or looks artificially generated, and tracks whether development slows down or stops soon after a token launches, which can be a sign of a rug pull. It also looks at how quickly a project gains stars and whether that growth looks organic. Alongside the score, Fineness calculates a reality gap: how much a token's market valuation is per point of actual scored development activity, meant to make it easier to see when a token's price is far ahead of any real building behind it. The project explicitly avoids giving price predictions or buy and sell advice. Everything shown is based on public GitHub data anyone could verify themselves, and project owners can dispute or correct how their repository is linked to a token through the public API. Under the hood, Fineness is built as a pnpm monorepo with a Next.js web app, a background worker using BullMQ and Redis for scanning jobs, and a Postgres database. It also offers a free public API with no key required. The project is written mostly in TypeScript, is released under the MIT license, and currently has 0 stars on GitHub.

prompts (copy fr)

prompt 1
Explain how the fineness score for a crypto token repo is calculated.
prompt 2
Help me query the fineness public API to get the score for a specific GitHub repo.
prompt 3
Walk me through self-hosting fineness with pnpm, Postgres, and Redis.
prompt 4
Show me how to interpret a reality gap number for a token I'm evaluating.

Frequently asked questions

what is fineness fr?

Fineness scores GitHub repos behind crypto tokens from 0 to 100 to reveal hidden forks, fake activity, and rug pull risk.

What language is fineness written in?

Mainly TypeScript. The stack also includes TypeScript, Next.js, Postgres.

What license does fineness use?

Use freely for any purpose, including commercial use, as long as you keep the copyright notice.

How hard is fineness to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is fineness for?

Mainly general.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.