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

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

Built distribution (wheel)

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

Total release size: 64.4 MB

Release files / electricore-3.8.4.tar.gz

Download URL electricore-3.8.4.tar.gz
Size 64.0 MB
Tags Source
SHA-256 checksum
How to use checksums
26d9d1c022d8497d4cd130057b2387dd0dabf542ec9a315c0f17d7681744f065
BLAKE2b-256 checksum
How to use checksums
d4fb757f9f40dcd47e926adffd34b39981143ac8cccf583d879eb33e01909b90
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.4-py3-none-any.whl

Download URL electricore-3.8.4-py3-none-any.whl
Size 419.0 kB
Tags Python 3
SHA-256 checksum
How to use checksums
4c6bc027d3b586d0f0c17f9caaa9222c32d218292a78e2b99079ef75eca0aa0b
BLAKE2b-256 checksum
How to use checksums
4a29333df00154278a8112a7a3a48de31823e0da8d89b14da7f620fd4bc6b5b1
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.4

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