⚡ 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

AGPL-3.0.

🙏 Remerciements

Polars · DuckDB · dlt · dbt · FastAPI · Pandera · Marimo · httpx · pydantic · uv.

Metadata

Release files for electricore 3.8.3

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for electricore 3.8.3
File	Size	Uploaded
electricore-3.8.3.tar.gz	64.0 MB	Oct 4, 2026	Details

Built distribution (wheel)

Table of built distributions (wheels) for electricore 3.8.3
File	Interpreter	ABI	Platform	Reset
electricore-3.8.3-py3-none-any.whl 417.7 kB Oct 4, 2026	Python 3	none	any	Details

Total release size: 64.4 MB

Release files / electricore-3.8.3.tar.gz

Download URL	electricore-3.8.3.tar.gz
Size	64.0 MB
Tags	Source
SHA-256 checksum How to use checksums	`479b3b1e74bff77aa19fcb9e1f3a484253cbafb821ffda5d2bbef534064340b9`
BLAKE2b-256 checksum How to use checksums	`8713911ce6181a46d1942936fe23c488c010dde7054b17eb53e60fe3711e64a3`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Energie-De-Nantes/electricore
Publishing commit: github.com/Energie-De-Nantes/electricore/tree/2a5289551eb3ac39e8d127ec04233bd166e43b84

Workflow

Publishing configuration: github.com/Energie-De-Nantes/electricore/blob/2a5289551eb3ac39e8d127ec04233bd166e43b84/.github/workflows/release.yml
Publishing logs: github.com/Energie-De-Nantes/electricore/actions/runs/37215039595/attempts/1

Artifact

Subject: electricore-3.8.3.tar.gz
SHA-256 checksum: 479b3b1e74bff77aa19fcb9e1f3a484253cbafb821ffda5d2bbef534064340b9 Verifying attestations

Release files / electricore-3.8.3-py3-none-any.whl

Download URL	electricore-3.8.3-py3-none-any.whl
Size	417.7 kB
Tags	Python 3
SHA-256 checksum How to use checksums	`f5de9bf601f1ff95bb05199b60dadd790936887f407e038250764c84f57c6b4f`
BLAKE2b-256 checksum How to use checksums	`35c4cccc29aa95bfbdd4c8aa69c407aa177573aa7e3e43f674355329b15df0b5`
Upload date	Oct 4, 2026
Uploaded using Trusted Publishing? What is trusted publishing?	Yes
Uploaded via	`twine/7.0.0 CPython/3.13.14`

Provenance

Identity

Publishing platform: GitHub Actions
Publishing repository: github.com/Energie-De-Nantes/electricore
Publishing commit: github.com/Energie-De-Nantes/electricore/tree/2a5289551eb3ac39e8d127ec04233bd166e43b84

Workflow

Publishing configuration: github.com/Energie-De-Nantes/electricore/blob/2a5289551eb3ac39e8d127ec04233bd166e43b84/.github/workflows/release.yml
Publishing logs: github.com/Energie-De-Nantes/electricore/actions/runs/37215039595/attempts/1

Artifact

Subject: electricore-3.8.3-py3-none-any.whl
SHA-256 checksum: f5de9bf601f1ff95bb05199b60dadd790936887f407e038250764c84f57c6b4f Verifying attestations