electricore 3.5.1

Moteur de traitement données énergétiques françaises - Architecture Polars/DuckDB pour flux Enedis

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