Tendances Hugging Face Hub

Description

Collecte les modèles, datasets et spaces en tendance depuis Hugging Face Hub. Détecte les deltas de téléchargements, likes, changements de score de tendance. Supporte les alertes pour les nouveaux repos d'organisations surveillées.

Source : API HuggingFace https://huggingface.co/api/{models|datasets|spaces}

Respect des rate limits

HuggingFace impose une limite de 500 requêtes par 5 minutes par IP.

L'acteur respecte automatiquement ces limites en:

• Lisant les en-têtes ratelimit de chaque réponse
• Ralentissant quand il reste < 10 requêtes
• Implémentant un backoff exponentiel sur les 429
• Limitant à 1 requête par 100ms minimum

Différenciation : historique et détection des changements

• Deltas calculés : downloads_delta, likes_delta, downloads_velocity_per_day
• Détection de changements : nouveaux repos, sorties du trending, augmentations de downloads/likes
• Alertes watchedOrgs : notification quand une org suivie publie un nouveau repo ou entre dans le top

Exemples

Input (mode snapshot)

{
  "mode": "snapshot",
  "repoTypes": ["models", "datasets"],
  "limit": 30,
  "watchedOrgs": ["meta-llama", "mistralai"],
  "maxItems": 100,
  "historyStoreName": "hf-hub-trends-history"
}

Output (snapshot)

{
  "record_type": "snapshot",
  "source": "huggingface",
  "observed_at": "2026-09-25T06:00:00.000Z",
  "repo_key": "models:meta-llama/Llama-3.3-70B-Instruct",
  "repo_type": "models",
  "repo_id": "meta-llama/Llama-3.3-70B-Instruct",
  "author": "meta-llama",
  "name": "Llama-3.3-70B-Instruct",
  "downloads": 1250000,
  "likes": 4532,
  "trendingScore": 245.8,
  "pipeline_tag": "text-generation",
  "library_name": "transformers",
  "source_url": "https://huggingface.co/meta-llama/Llama-3.3-70B-Instruct"
}

Output (change détecté)

{
  "record_type": "change",
  "source": "huggingface",
  "observed_at": "2026-09-25T12:00:00.000Z",
  "previous_observed_at": "2026-09-25T06:00:00.000Z",
  "change_type": "downloads_increase,likes_increase",
  "diff_type": "changed",
  "repo_id": "meta-llama/Llama-3.3-70B-Instruct",
  "downloads": 1275000,
  "likes": 4590,
  "downloads_delta": 25000,
  "likes_delta": 58,
  "downloads_velocity_per_day": 100000,
  "hours_since_last": 6,
  "changes": [
    {
      "field": "downloads",
      "old": 1250000,
      "new": 1275000,
      "delta_abs": 25000
    },
    {
      "field": "likes",
      "old": 4532,
      "new": 4590,
      "delta_abs": 58
    }
  ]
}

Planification quotidienne

Pour suivre les tendances quotidiennement :

Schedules → Add schedule
- Time: 10:00 UTC
- Run input: {"mode":"changes","repoTypes":["models"],"limit":30,"maxItems":100}

Le mode changes détecte les nouveaux repos dans le top et les variations de métriques (downloads, likes, trending score).

Sources et licences

• Hugging Face Hub API : https://huggingface.co/docs/hub/api
• Rate limits : 500 req / 5 min par IP (respecté automatiquement avec backoff)
• Accès : sans clé API

Tarification pay-per-event suggérée

• Événement record : 0,0001 $ par enregistrement
• Événement change-detected : 0,001 $ par changement détecté

Limites

• Rate limits : L'acteur respecte la limite de 500 req/5 min. Pour collecter beaucoup de repos (ex: 100 de chaque type), il peut prendre quelques minutes.
• Trending uniquement : Ne collecte que les repos en tendance, pas tous les repos HF.
• Pas de pagination : Limite max de 100 repos par type (limite API HF).