carbon-fr
API d'intensité carbone de l'électricité française (gCO₂eq/kWh) — souveraine, open source et dev-first. L'équivalent français de carbonintensity.org.uk, bâti sur les données ouvertes RTE/ODRÉ.
Ficha actualizada 23 sept 2026, 0:56 · upstream 23 sept 2026, 0:48 · release v0.7.1
Qué es carbon-fr
Descripción editorial construida a partir del repositorio, su documentación y sus señales de mantenimiento.
carbon-fr est une API RESTful dédiée à la fourniture d'intensités carbone du réseau électrique français, exprimées en gCO₂eq/kWh. Elle permet aux développeurs et aux machines de consommer des données précises sur l'empreinte carbone de l'électricité produite dans le pays.
L'API est conçue comme une solution souveraine et auto-hébergeable : aucune dépendance propriétaire n'est requise, les licences OSI sont respectées. Elle s'appuie sur les données ouvertes RTE (Réseau Transversal d'Électricité) via l'ODRÉ (Open Data Repository), et expose également des données météorologiques, de production renouvelable estimée, de prix du spot, ainsi que des méthodes de calcul validées par le cycle de vie ADEME.
L'intégration est simple : aucune installation n'est nécessaire. L'instance hébergée répond immédiatement à une requête HTTP standard. Les données sont disponibles en temps réel (intensité courante) ou sur demande (historique, prévisions). Une collection Bruno permet la consommation via des requêtes JSON-serialized.
Les endpoints principaux couvrent l'intensité courante et historique, le mix de production par filière, les échanges transfrontaliers, la météo nationale, la production renouvelable estimée, le prix du spot électrique, ainsi que des outils d'éligibilité pour les électrolyseurs (rfnbo/low-carbon) et de scheduling carbon-aware. L'API expose également un catalogue de méthodes de calcul, une documentation OpenAPI 3.1, et une page dédiée aux électrolyseurs.
Les données sont disponibles sous deux méthodologies principales : « rte-direct » (estimation RTE, combustion directe, national uniquement) et « acv-ademe » (cycle de vie ADEME, national + régions métropolitaines). Des prévisions d'intensité sont fournies via des modèles climatiques (climatology@1 ou acv-ademe@2), et une fenêtre de créneau le plus bas-carbone est proposée en fonction des cadres d'éligibilité.
L'API respecte les standards OpenAPI 3.1, expose un Swagger UI, et propose un SDK TypeScript via @carbon-fr/sdk. Elle gère la résilience face aux quotas RTE (un poller unique alimente la base, l'API sert tous les clients), le RGPD (IP non stockée, empreinte SHA-256 salée pour déduplication) et la séc
- Calculer l'empreinte carbone d'un véhicule électrique en temps réel à partir de l'intensité du réseau national.
- Planifier une recharge de batterie ou un voyage électrique en fonction des données d'intensité en direct.
- Afficher la consommation moyenne et historique par région pour comparer les rendements énergétiques locaux.
- Évaluer le coût carbone d'un projet d'électrolyseur selon l'empreinte du réseau local (rfnbo/low-carbon eligibility).
- Concevoir un système de scheduling carbon-aware qui optimise la production renouvelable en fonction des prévisions climatiques.
- Visualiser et analyser les échanges transfrontaliers d'électricité pour comprendre le carbone importé ou exporté entre pays.
- API souveraine et auto-hébergeable, sans dépendance obligatoire à une plateforme propriétaire.
- OpenAPI 3.1 + Swagger UI + collection Bruno pour une consommation facile via JavaScript/TypeScript.
- Données en temps réel (intensité courante) et historiques avec prévisions climatiques.
- Modèles de calcul validés par le cycle de vie ADEME (acv-ademe@2).
- Outils d'éligibilité pour les électrolyseurs (rfnbo/low-carbon) intégrés directement dans l'API.
- Architecture hexagonale permettant des changements de source de données sans toucher au cœur métier.
- Sécurité renforcée : webhooks signés, anti-SSRF, et gestion RGPD via empreinte salée.
- L'intensité est estimée (non mesurée) pour les régions métropolitaines ; la méthode exacte n'est pas publiée.
- La prévision d'intensité utilise des modèles climatiques et ne représente pas une mesure directe.
- Les données de production renouvelable sont estimées à partir de la météo, non mesurées en temps réel.
- L'API ne fournit pas le prix du spot électrique (ENTSO-E) ni les coûts de production (LCOE).
- Le cycle de vie ADEME est basé sur des données d'importations et exportations ; l'intensité locale n'est pas calculée directement.
- La fenêtre « électrolyseur » est une estimation basée sur des critères fixes, sans ajustement dynamique en temps réel.
- L'API ne gère pas les données de production par filière (hydro, nucléaire, thermique) à l'échelle régionale.
- Le quota RTE n'est disponible que pour le réseau national ; la régionalisation est dérivée via des méthodes indirectes.
Perfil de infraestructura
Estimación inicial derivada del repositorio y de los servicios detectados.
Despliegue detectado
Qué señales reales de instalación hemos encontrado.
Déployez carbon-fr en mode serveur avec un conteneur Docker. Utilisez une base PostgreSQL (port 5432) et exposez l'API sur port 8080. Activer la limite de débit si nécessaire : set CARBONFR_RATELIMIT_ENABLED=1. Pour héberger, utilisez Docker Compose ou le containerd. La clé API est délivrée via la commande mint-key dans un environnement sécurisé (pas en clair). Le SDK TypeScript se déplace avec le projet et nécessite une installation locale des dépendances.
Stack y dependencias
Componentes inferidos a partir de manifests, configuración y documentación.
Puede sustituir a
Relaciones detectadas por el análisis del repositorio y su categoría.
Experiencia real de la comunidad
Ayuda a contrastar la estimación automática con instalaciones reales.
Todavía no hay datos comunitarios para este proyecto.