{"id":47944211,"url":"https://github.com/dataiku/dss-plugin-co2","last_synced_at":"2026-04-04T08:20:47.051Z","repository":{"id":38414441,"uuid":"440475611","full_name":"dataiku/dss-plugin-co2","owner":"dataiku","description":null,"archived":false,"fork":false,"pushed_at":"2025-02-07T11:11:56.000Z","size":90,"stargazers_count":0,"open_issues_count":1,"forks_count":1,"subscribers_count":24,"default_branch":"main","last_synced_at":"2025-02-07T11:35:26.519Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/dataiku.png","metadata":{"files":{"readme":"README.md","changelog":"CHANGELOG.md","contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":"CODE_OF_CONDUCT.md","threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2021-12-21T10:21:37.000Z","updated_at":"2025-02-07T10:55:20.000Z","dependencies_parsed_at":"2025-02-07T11:29:24.740Z","dependency_job_id":"49ab6401-ab91-4c3c-8512-72dccf84edda","html_url":"https://github.com/dataiku/dss-plugin-co2","commit_stats":null,"previous_names":[],"tags_count":4,"template":false,"template_full_name":"dataiku/dss-plugin-template","purl":"pkg:github/dataiku/dss-plugin-co2","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataiku%2Fdss-plugin-co2","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataiku%2Fdss-plugin-co2/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataiku%2Fdss-plugin-co2/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataiku%2Fdss-plugin-co2/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/dataiku","download_url":"https://codeload.github.com/dataiku/dss-plugin-co2/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/dataiku%2Fdss-plugin-co2/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31392731,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T04:26:24.776Z","status":"ssl_error","status_checked_at":"2026-04-04T04:23:34.147Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2026-04-04T08:20:46.118Z","updated_at":"2026-04-04T08:20:47.022Z","avatar_url":"https://github.com/dataiku.png","language":"Python","readme":"# Co2 Converter Plugin\n\n![Build status](https://github.com/dataiku/dss-plugin-co2/actions/workflows/auto-make.yml/badge.svg) ![GitHub release (latest by date)](https://img.shields.io/github/v/release/dataiku/dss-plugin-co2?logo=github) ![Support level](https://img.shields.io/badge/support-Unsupported-orange)\n\nThis Dataiku plugin provides 3 recipes to:\n- Convert electricity consumption into co2 emissions, according to the carbon intensity of a given location\n- Retrieve energy mix from a given location (thanks to electricityMap API)\n- Retrieve the forecasted carbon intensity (thanks to electricityMap API)\n\n## Description\n\nThis plugin allows you to:\n\n- Convert electricity consumption into co2 emission based on the carbon intensity of the location and date.\n- Retrieve energy mix from a given location.\n- Retrieve the forecasted carbon intensity.\n\n## Data providers\n\nThis plugin is mainly based on data from [Electricity Maps](https://electricitymaps.com/), a paid data provider. You’ll need to request an API token using the [contact form](https://electricitymaps.com/?utm_source=dataiku#contactform). Before that, ensure the location you want to retrieve the carbon intensity from is covered on the [Electricity Maps app](https://app.electricitymaps.com/map).\n\nYou can also convert electricity consumption into co2 emissions for free by using [RTE](https://data.rte-france.com/en), but it only covers France.\n\n## Setup\n\nOnce the plugin is installed from the store, if using Electricity Maps, to set your token, go to **Plugin \\\u003e CO2 Converter \\\u003e Settings \\\u003e Electricity Maps API Configuration \\\u003e + Add preset**.\n\n## How to use\n\n### Electricity to CO2 emissions conversion:\n\nThis component adds a recipe to the flow in which you need to specify a Date column and an electricity consumption column:\n\nBy default, the API provider is RTE.\nOnce set up, the plugin automatically queries the API based on the date range from the input dataset, to avoid making too many requests. Also, due to electricity Maps API limitations, it creates\nchunks of 10 days for this data provider.\n\nSince electricity maps requires a geopoint column, it allows multiple locations in the same input dataset. If you are using Electricity Maps, you will need to use a previously configured plugin preset before specifying the geopoint columns of your dataset. If you have longitude and latitude columns, you can create a geopoint using the [dedicated data preparation processor](https://doc.dataiku.com/dss/latest/preparation/processors/geopoint-create.html).\n\nFinally, run the plugin recipe to retrieve the closest carbon intensity from your location. The recipe outputs a dataset that appends 3 new columns to the input dataset:\n\n- co2_date_time (closest date available from the API provider. It may be interesting to use [metrics \u0026 checks](https://knowledge.dataiku.com/latest/courses/automation/metrics-checks-summary.html) to check the difference between the requested and provided dates).\n- carbon_intensity (gCO₂eq/kWh)\n- co2_emission (kgCO₂eq)\n\n### Retrieve energy mix:\n\nThis component adds a recipe to the flow in which you need to specify an Electricity Maps API preset, a Date column, and a geopoint column. Then, you can select the columns from the Electricity Maps API you want to retrieve, among:\n\n- Power Consumption Breakdown\n- Power Production Breakdown\n- Power Import Breakdown\n- Power Export Breakdown\n- Renewable percentage\n- Fossil-free Percentage\n- Power Consumption Total\n- Power Production Total\n- Power Import Total\n\n\nOnce you run the recipe, your initial dataset will be enriched with the selected columns according to the location and date time.\n\n### Retrieve forecasted carbon intensity:\n\nThis component adds a recipe to the flow in which you need to specify an Electricity Maps API preset and a geopoint column. \n\nOnce you run the recipe, you’ll have the carbon_intensity column containing the forecasted carbon intensity and the co2_date_time containing the date and time of the predicted values.\n\n## Release notes\n\nSee the [changelog](CHANGELOG.md) for a history of notable changes to this plugin.\n\n## License\n\nThis plugin is distributed under the [Apache License version 2.0](LICENSE).\n","funding_links":[],"categories":[],"sub_categories":[],"project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataiku%2Fdss-plugin-co2","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fdataiku%2Fdss-plugin-co2","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fdataiku%2Fdss-plugin-co2/lists"}