Practical overview
When it fits
Use OpenRarity when you need collection-level NFT rarity scores and rankings from a Python library or the repository’s command-line tool.
Who it is for
- Developers integrating NFT rarity calculations into marketplaces or collection-analysis tools.
- Users who need collection-level rarity scores and rankings in JSON or CSV.
Documented uses
- Generate rarity scores and ranks for NFT collections.
- Add OpenRarity calculations to a Python project.
- Produce structured rarity outputs for collection analysis.
Requirements & limits
- The documented stack requires Python 3.10 or later; the repository uses Poetry, NumPy and PyTest.
- The README describes the library as a beta preview.
- The shell tool is documented for use from a downloaded repository, while the Python package is available for project integration.
Check current requirements in the official documentation. Source-based guidance does not mean OpenViST has run or independently tested this project.
Generate collection rarity scores and rankings
Use the repository’s shell tool to produce JSON or CSV scoring and rank outputs for NFT collections.
Before you start
- A downloaded copy of the repository
- Python 3.10 or later
- Poetry and project dependencies installed
Steps
Install the project dependencies with
poetry install.Run the documented collection-scoring script with collection identifiers, for example the command below.
python -m scripts.score_real_collections boredapeyachtclub proof-moonbirds
Expected outcome
The shell tool generates OpenRarity scoring and rank results in JSON or CSV format.
Guide limitations
- The README documents the command and output formats but does not specify how to select between JSON and CSV.
- The library is described as a beta preview.
Sources & review
Source record details
- Source availability
- Active
- Sources checked
- 16 October 2026
- Original website title
- OpenRarity/open-rarity · Official homepage title · retained in its source language

