Skip to main content

⚡ ElectriCore — moteur de traitement des données énergétiques

CI License: AGPL-3.0 Python 3.12+ Polars Ruff Docs

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.5

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.5
File Size Uploaded Provenance Actions
electricore-3.8.5.tar.gz 64.0 MB With provenance Details for electricore-3.8.5.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for electricore 3.8.5
File Interpreter ABI Platform Actions
electricore-3.8.5-py3-none-any.whl Python 3 none any Details for electricore-3.8.5-py3-none-any.whl

Total release size: 64.4 MB

Release files / electricore-3.8.5.tar.gz

Download URL electricore-3.8.5.tar.gz
Size 64.0 MB
Tags Source
SHA-256 checksum
How to use checksums
3a5c723ad9614a20ac9c8fbb6672c3acda6b3645bde1b89faffaba535cf24d58
BLAKE2b-256 checksum
How to use checksums
23dbf94371ab2f20baef91911c1ae75d567adb9d82e4ef8797a5823298d14195
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

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

Download URL electricore-3.8.5-py3-none-any.whl
Size 419.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
e7a074b7177437b322370e6e2896c9f138915c986f9116039261939a2383dfaf
BLAKE2b-256 checksum
How to use checksums
adc96be3e7a069dd91b6911180ff4dbcbdd6ebcb33ebdcee263f0d9239056114
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/7.0.0 CPython/3.13.16

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.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

Security for electricore 3.8.5

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.

Full provenance

Both files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for electricore-3.8.5.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on Oct 30, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

3.8.5 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page