Sources
The collector reads two addresses of the public Hugging Face API, without a key. Models come from the model list sorted by trending score; the first 40 are kept. Papers come from the daily papers list of the current day; the 30 most upvoted are kept, the first 12 with the complete abstract.
https://huggingface.co/api/models?sort=trendingScore&limit=60https://huggingface.co/api/daily_papers?date=YYYY-MM-DD&limit=100
When the current day has no paper list, which happens on weekends and holidays, the collector looks back up to 4 days and uses the most recent one. The edition then says which day its papers belong to. For the leading models that are not themselves quantisations, one extra request each finds the three most downloaded repositories that declare the model as their base.
Sources named in earlier plans for this site were dropped after checking them: Papers with Code now redirects to Hugging Face Papers, and Product Hunt requires a token and restricts commercial use of its data. GitHub repositories are left to GitHub Trending Today (opens in a new tab).
The one rule
The order of models is the order Hugging Face returns. A model is moved out of the ranking, into a list of its own, when all three conditions hold:
- it has 100 or more likes;
- the repository was created 3 or more days before the collection, because download counts lag for new repositories;
- its downloads over the last 30 days are fewer than its likes divided by 10.
The reason is that the trending score responds to likes, and likes can be gathered without anyone using a model. On the day this rule was written, the first model of the trending list had about five thousand likes and zero downloads. The rule does not say why; it reports the two numbers and steps the entry aside.
What is never done
- No score of our own is computed, and no model is promoted.
- No abstract is summarised, translated or rewritten. Excerpts are cut at a word boundary and marked.
- No field is guessed. A missing parameter count, licence or code link is shown as missing.
- No thumbnail is generated for a paper, and figures from papers are not copied.
Schedule and storage
The collector runs on a timer every three hours, starting at 00:07 UTC, so the current day is refreshed as votes and downloads move. Each run writes the latest edition and the day’s compact record: the top 15 models and papers with their numbers. The last run of a day is the one the archive keeps.
If the model list cannot be read or comes back empty, nothing is written and the previous edition stays, with its date. Every page prints the collection time, and shows a notice when the edition is more than 36 hours old.
The snapshot shipped with the site
The pages you receive as HTML are built from a snapshot collected when the site was built, by the same code the scheduled collector runs. That snapshot is labelled “shipped with the site build” wherever its numbers appear. When the collector has a newer edition, your browser replaces the lists on the home, models and papers pages and the label changes.
Limits you should know
- Download counts are Hugging Face’s 30-day figures. Models served mainly through an API or another host look smaller than they are.
- Licence tags are chosen by uploaders and can be wrong or differ from the base model’s licence.
- Paper upvotes measure the attention of one community on one day.
- Day-over-day changes need two editions; a model’s first day on the list shows none.