Skip to content
ltoinelPublic

About

Self-hosted household budget app: automatic bank sync (woob), auto-categorization, monthly budgets, trends, iPhone push alerts and a read-only MCP server for AI agents. Logiciel gestion budget familial gratuit

Topics

Resources

Contributing

Security policy

Stars

31 stars

Watchers

0 watching

Forks

Latest commit

 

History

303 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Carbure

Carbure

Français · English

Reprenez le contrôle de votre budget.
Vos comptes bancaires synchronisés automatiquement, vos dépenses catégorisées,
vos budgets suivis au jour le jour — sur le web, sur iPhone et sur Android. Hébergé chez vous, gratuit et open source.

💸 Gratuit, sans abonnement · 🏠 100 % hébergé chez vous · 🙅 Aucun service cloud tiers

▶ Essayer la démo en ligne

Télécharger sur l'App Store (iPhone) Disponible sur Google Play (Android)
📱 Applications mobiles gratuites, sans publicité ni collecte de données, connectées à votre serveur

CI Sécurité Release Docker pulls Docs License: MIT

Voir le teaser de Carbure (1 min) sur YouTube

👉 Toutes les fonctionnalités, avec chaque écran

Fonctionnalités

  • 🔄 Zéro saisie : les opérations arrivent chaque jour de votre banque, en direct avec woob, sans agrégateur ; ou importez vos relevés (OFX, QIF, CSV, CAMT.053).
  • 🏷️ Catégorisation automatique par des règles simples (« CARREFOUR → Supermarché »), proposées quand vous classez une nouvelle transaction.
  • 🎯 Budgets mensuels par catégorie, les sous-catégories s'additionnant dans leur parent, et le flux du mois : d'où vient l'argent, où il part.
  • 📈 Tendances sur 3, 6 ou 12 mois, comparées à la période précédente ou à l'an dernier.
  • ✅ Pointage des transactions et 🔁 opérations récurrentes repérées toutes seules (salaire, loyer, abonnements).
  • 🔔 Alertes par notification push ou email : grosse dépense, règle choisie, budget presque atteint.
  • 📊 Insights : vos propres indicateurs du mois (courses, carburant, abonnements…).
  • 👨‍👩‍👧 Pensé pour le foyer : plusieurs utilisateurs sur les mêmes comptes, chacun sa langue et ses appareils ; sauvegarde et restauration en un ZIP.
  • 🤖 Votre agent IA interroge vos comptes (« combien en restaurants cette année ? ») par un serveur MCP intégré, en lecture seule : Claude, ChatGPT, Cursor, Copilot, Gemini…
  • 🌗 Clair ou sombre, accessible (WCAG 2.2 AA), en français, anglais, espagnol, italien, allemand et portugais.

Carbure s'appuie sur les modules de woob, qui couvrent surtout les banques françaises.

Applications mobiles

Les applications iPhone (iOS 26) et Android (Android 8.0) se connectent à votre serveur : transactions, pointage, budgets, tendances, synchronisation, Face ID ou empreinte et notifications push. Gratuites, sans publicité ni collecte de données, disponibles en France pour le moment (détails).

Voir la vidéo « Carbure sur iPhone et Android : votre budget, dans votre poche » sur YouTube

Vos données restent chez vous

Carbure tourne sur votre propre serveur (un NAS suffit) : pas de compte à créer, pas d'agrégateur, pas de cloud. Vos identifiants et vos données bancaires restent dans votre base. Carbure ne contacte que votre banque (woob), l'API publique de GitHub une fois par jour pour signaler une nouvelle version (désactivable), et, si vous les activez, le relais des notifications mobiles et votre serveur d'email.

flowchart LR
    bank[(Banques)] -->|woob| sync[Synchronisation]
    subgraph Carbure
        sync --> rules[Règles de<br/>catégorisation] --> db[(MariaDB)]
        api[API REST PHP] <--> db
    end
    portal[Portail web] <--> api
    mobile[Apps iPhone<br/>et Android] <--> api
    ai[Agent IA] <-->|MCP| api
    sync -->|relais Carbure Push| push[Notifications<br/>mobiles]
Loading

Comparaison

Carbure Firefly III Actual Budget Kresus Sure ezBookkeeping
Connexion bancaire Directe, via woob Agrégateurs tiers Agrégateurs tiers Directe, via woob Agrégateurs tiers Import de fichiers
Sous-catégories additionnées dans leur parent ✅ ➖ ⚠️ ➖ ✅ ⚠️
Plusieurs utilisateurs sur les mêmes données ✅ ⚠️ ✅ ➖ ✅ ⚠️
Apps natives iPhone et Android, notifications push ✅ ⚠️ ➖ ➖ ⚠️ ➖
Serveur MCP intégré pour les agents IA ✅ ➖ ➖ ➖ ✅ ✅
Import de fichiers (OFX, QIF, CSV, CAMT.053) ✅ ⚠️ ✅ ⚠️ ⚠️ ✅
Plusieurs devises ➖ ✅ ➖ ⚠️ ✅ ✅

✅ oui · ⚠️ en partie · ➖ non — 👉 Comparatif complet : 24 critères (hébergement, données bancaires, budget, foyer et appareils, API), avec les points forts de chacun.

Installation

Pour Comment
Démo en ligne voir Carbure sans rien installer demo.carbure.org
Démo chez vous essayer avec un foyer d'exemple docker run --rm -p 8080:80 ltoinel/carbure:demo
Docker (recommandé) gérer le vrai budget du foyer voir ci-dessous
NAS Synology un NAS à la maison tutoriel pas à pas
YunoHost un serveur YunoHost paquet carbure_ynh (tutoriel)
Serveur web PHP 8.2 et MariaDB/MySQL déjà en place installation sans Docker

Avec Docker, l'image ltoinel/carbure contient nginx, PHP et woob ; docker/docker-compose.yml y ajoute MariaDB :

git clone https://github.com/ltoinel/Carbure.git && cd Carbure/docker
docker compose pull && docker compose up -d

Ouvrez http://localhost:8080/ : l'assistant d'installation crée la base et le compte administrateur en trois clics. Pour les applications mobiles, placez Carbure derrière un proxy inverse en HTTPS.

👉 Installation détaillée, mises à jour, configuration, API et sécurité : la documentation.

Développer

git clone https://github.com/ltoinel/Carbure.git && cd Carbure
./start.sh

./start.sh lance Carbure avec le code du dépôt monté en direct et un foyer d'exemple sur http://localhost:8000/portal/ (admin / admin-password) ; ./start.sh --help liste ses options. Tests et architecture : documentation développeur.

Assistance

Rejoindre le serveur Discord de Carbure Voir les vidéos de Carbure sur YouTube

Questions et entraide sur le Discord, FAQ dans l'assistance. Un bug ? Ouvrez une issue ; une faille de sécurité se signale en privé (SECURITY.md).

Contribuer

Les contributions sont les bienvenues : lisez CONTRIBUTING.md (démarche, conventions, tests) et AGENTS.md (règles du code), et choisissez une tâche dans TODO.md. Si Carbure vous est utile, une ⭐ aide d'autres personnes à le découvrir.

Merci à toutes les personnes qui ont contribué à Carbure, par leur code, leurs idées ou leurs retours :

Ludovic Toinel Gaël Matlink GIL Morgan Romain Forlot yann vignolet

Et tous les autres, sur la liste des contributeurs et dans les issues.

Licence

MIT © Ludovic Toinel. Logiciels tiers embarqués et leurs licences : THIRD-PARTY-NOTICES.md.

About

Self-hosted household budget app: automatic bank sync (woob), auto-categorization, monthly budgets, trends, iPhone push alerts and a read-only MCP server for AI agents. Logiciel gestion budget familial gratuit

Topics

Resources

Contributing

Security policy

Stars

31 stars

Watchers

0 watching

Forks

Releases

Sponsor this project

Packages

Used by

Contributors

Languages