⚡ ElectriCore — moteur de traitement des données énergétiques
ElectriCore est un outil libre pour reprendre le contrôle des données du réseau électrique français. Il transforme les flux bruts Enedis (le distributeur) en données structurées, calculées et exploitables — facturation calendaire, abonnements, énergies par cadran, TURPE, taxes — exposées via une API REST pour Odoo, des notebooks et tout outil de suivi énergétique.
Pour qui ? Un fournisseur d'électricité (EDN, Enargia…) qui veut recalculer lui-même ce qu'il facture, à partir de la donnée brute Enedis, sans dépendre des agrégats « moisniversaire » du distributeur — inexploitables pour une facturation au mois calendaire.
Stack : Polars + DuckDB (zéro pandas), ingestion ELT dlt + dbt, FastAPI, Pandera. Tout le code et la doc sont en français — le domaine (Enedis, CRE, TURPE, accise) l'est intrinsèquement.
📖 Documentation — 5 portes, une par rôle
Le site de documentation est rangé par rôle de lecture, en escalier (quoi → comment s'en servir → comment c'est fait → comment le faire évoluer) :
- Comprendre — ce qu'ElectriCore calcule et pourquoi, pour un public non technique.
- Facturer — le cycle de facturation au quotidien, bot Telegram et notebooks.
- Déployer — installer et administrer une instance (VPS, Docker Compose, secrets).
- Contribuer — architecture, exemples de code, patterns, installation dev et tests.
- Maintenir — décisions d'architecture, releases, suivi réglementaire.
🚀 Démarrage rapide
git clone https://github.com/Energie-De-Nantes/electricore.git
cd electricore
uv sync # runtime : core + API + bot (voir la section Contribuer pour les extras)
uv run uvicorn electricore.api.main:app --reload
curl http://localhost:8000/health
Détails d'installation, ingestion, pipelines et API : voir Contribuer → Développer.
📄 Licence
🙏 Remerciements
Polars · DuckDB · dlt · dbt · FastAPI · Pandera · Marimo · httpx · pydantic · uv.
1 maintainer
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file electricore-3.8.0.tar.gz.
File metadata
- Download URL: electricore-3.8.0.tar.gz
- Upload date:
- Size: 58.6 MB
- Tags: Source
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
becdee865bcf2933d8771864f2fa95a453fa13063f3074952095d193451dcbe1
|
|
| MD5 |
34afdae5e37fd3f271b1f41349df3d1f
|
|
| BLAKE2b-256 |
9f00549536ee26736afca0f5259531079edb212c9572488566f37bf35b10dd18
|
Provenance
The following attestation bundles were made for electricore-3.8.0.tar.gz:
Publisher:
release.yml on Energie-De-Nantes/electricore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
electricore-3.8.0.tar.gz -
Subject digest:
becdee865bcf2933d8771864f2fa95a453fa13063f3074952095d193451dcbe1 - Sigstore transparency entry: 2335057437
- Sigstore integration time:
-
Permalink:
Energie-De-Nantes/electricore@fbf86776967eff88ecec7f6daad7001a30578e81 -
Branch / Tag:
refs/tags/v3.8.0 - Owner: https://github.com/Energie-De-Nantes
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fbf86776967eff88ecec7f6daad7001a30578e81 -
Trigger Event:
push
-
Statement type:
File details
Details for the file electricore-3.8.0-py3-none-any.whl.
File metadata
- Download URL: electricore-3.8.0-py3-none-any.whl
- Upload date:
- Size: 415.6 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? Yes
- Uploaded via:
twine/7.0.0 CPython/3.13.14
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
23aa7f86c1233685eaf5b5eeb2c5d85bd7813abf48c2cf2dd9a73cbf681f62c3
|
|
| MD5 |
967575f28313a5e3a45ba8ce14070d37
|
|
| BLAKE2b-256 |
7bca07b966f2088aa2318cbde7d84991761c32cee015c2d05fc8fc1156948f06
|
Provenance
The following attestation bundles were made for electricore-3.8.0-py3-none-any.whl:
Publisher:
release.yml on Energie-De-Nantes/electricore
-
Statement:
-
Statement type:
https://in-toto.io/Statement/v1 -
Predicate type:
https://docs.pypi.org/attestations/publish/v1 -
Subject name:
electricore-3.8.0-py3-none-any.whl -
Subject digest:
23aa7f86c1233685eaf5b5eeb2c5d85bd7813abf48c2cf2dd9a73cbf681f62c3 - Sigstore transparency entry: 2335057463
- Sigstore integration time:
-
Permalink:
Energie-De-Nantes/electricore@fbf86776967eff88ecec7f6daad7001a30578e81 -
Branch / Tag:
refs/tags/v3.8.0 - Owner: https://github.com/Energie-De-Nantes
-
Access:
public
-
Token Issuer:
https://token.actions.githubusercontent.com -
Runner Environment:
github-hosted -
Publication workflow:
release.yml@fbf86776967eff88ecec7f6daad7001a30578e81 -
Trigger Event:
push
-
Statement type:
