Initial vault setup

2026-06-09 18:40:21 +02:00
commit bda02d587f
3692 changed files with 402457 additions and 0 deletions
@@ -0,0 +1,116 @@
+---
+title: Baby Buddy
+created: 2026-06-07
+updated: 2026-06-07
+type: app
+tags: [catalogue, tracking, bebe, parenting, django, python, postgresql]
+confidence: high
+contested: false
+sources: [https://selfh.st/apps/baby-buddy, https://github.com/babybuddy/babybuddy]
+---
+
+# Baby Buddy
+
+> La référence auto-hébergée pour suivre sommeil, tétées, changes et tummy time de bébé, avec dashboard intelligent et prédictions basées sur l'historique.
+
+| Métadonnée | Valeur |
+| :--- | :--- |
+| **Site web** | https://docs.baby-buddy.net/ |
+| **GitHub** | https://github.com/babybuddy/babybuddy |
+| **License** | BSD-2-Clause |
+| **Langage principal** | Python (Django) |
+| **Étoiles GitHub** | ⭐2.8k |
+| **Dernière MAJ** | 2026-05-25 (v2.9.2) |
+| **Catégorie** | [[cat-tracking]] |
+
+## Description
+
+Baby Buddy est le **tracker de bébé historique** de la communauté self-hostée, mature, complet et multi-langue (24 langues dont le français). Né du besoin de parents développeurs de pouvoir **prédire les besoins de leur nourrisson** plutôt que de naviguer à l'instinct, le projet propose une approche « data-driven » du parenting : plus vous saisissez d'événements, plus les prédictions (prochains changements, prochaines tétées, fenêtres de sommeil) deviennent fiables.
+
+Les **entités suivies** couvrent tout le quotidien : sommeil avec qualité (1 à 5 étoiles) et durée, tétées au sein (gauche/droite avec minuteur), biberons avec volume et type de lait, tire-laits (sessions et volume), changes de couches, tummy time (éveil moteur sur le ventre), mesures de croissance (poids, taille, périmètre crânien avec courbes OMS), bains, et depuis la v2.9.2 les **médicaments** avec dosage, unité et intervalle entre prises. Chaque entrée est horodatée, modifiable a posteriori, et associée à un ou plusieurs enfants.
+
+Le **dashboard** est la pièce maîtresse : il affiche en un coup d'œil la dernière activité de chaque type, des **graphiques Plotly** (sommeil sur 24h, fréquence des tétées, volumes ingérés) et des **rapports** détaillés (rapport de sommeil, rapport d'alimentation, courbes de croissance). L'**API REST** exposée est complète, ce qui permet des intégrations avec Home Assistant, des Apple Shortcuts, et désormais un **serveur MCP** (Model Context Protocol) pour interroger les données via un assistant IA. Le projet supporte aussi 100+ contributeurs et une documentation très aboutie (MkDocs).
+
+## Installation
+### Via Docker (recommandé)
+```yaml
+services:
+  babybuddy:
+    container_name: babybuddy
+    image: lscr.io/linuxserver/babybuddy:latest
+    restart: unless-stopped
+    ports:
+      - "8000:8000"
+    environment:
+      - PUID=1000
+      - PGID=1000
+      - TZ=Europe/Paris
+      - DOCKER_MODS=linuxserver/mods:latest-django
+    volumes:
+      - babybuddy-config:/config
+    depends_on:
+      - db
+
+  db:
+    image: postgres:16-alpine
+    restart: unless-stopped
+    environment:
+      - POSTGRES_DB=babybuddy
+      - POSTGRES_USER=babybuddy
+      - POSTGRES_PASSWORD=***    volumes:
+      - babybuddy-db:/var/lib/postgresql/data
+
+volumes:
+  babybuddy-config:
+  babybuddy-db:
+```
+Créer un compte admin via l'écran de connexion initial (`/login/`, le premier inscrit devient super-utilisateur).
+
+### Installation manuelle
+1. Cloner : `git clone https://github.com/babybuddy/babybuddy.git`
+2. Python 3.12+ et Poetry : `poetry install`
+3. Copier `.env.template` en `.env`, configurer `DATABASE_URL` (PostgreSQL recommandé)
+4. Lancer les migrations : `python manage.py migrate`
+5. Créer un super-utilisateur : `python manage.py createsuperuser`
+6. Démarrer : `python manage.py runserver` ou via Gunicorn en production
+
+## Configuration
+
+- **Premier compte créé** : le rôle est `super-user`, permettant d'accéder à `/admin/` pour gérer utilisateurs et enfants.
+- Régler la **langue et le fuseau horaire** par utilisateur dans `/user/settings/`.
+- Configurer **l'axe des abscisses du dashboard** : heures de la journée, intervalles fixes, ou durée depuis maintenant.
+- Activer le **mode interactif** du dashboard pour que les aidants (conjoint, grands-parents) puissent ajouter des événements rapidement.
+- Activer le **serveur MCP** (optionnel) si vous voulez interroger les données via un assistant IA.
+- Sauvegarder régulièrement la base PostgreSQL ET le volume de configuration.
+
+## Alternatives
+### Open source
+- [[app-sprout-track]] — alternative Next.js plus moderne, mobile-first et multi-familles
+- **Finnberry** — app Flutter, plus jeune mais prometteuse
+- **Grocy** — pas spécifique bébé, mais gère routines et stocks
+- **BottleJS** — projet minimaliste de suivi des biberons (peu maintenu)
+### Propriétaires
+- **Huckleberry** — IA de prédiction sommeil (freemium, abonnements)
+- **Baby Tracker (Nighp)** — référence mobile mais cloud-only
+- **Tinybeans** — journal bébé + réseau social familial payant
+
+## Sécurité
+
+- **Authentification Django** robuste avec hash de mot de passe, CSRF tokens, et sessions sécurisées.
+- **HTTPS obligatoire** : déployer derrière Traefik/Caddy avec Let's Encrypt, surtout si l'instance est accessible depuis l'extérieur.
+- Si utilisation derrière un **reverse proxy**, bien configurer `X-Forwarded-For` (le projet utilise `django-ipware` pour la confiance des IP).
+- **Limiter l'inscription publique** dans `/admin/` une fois votre compte créé, ou n'autoriser que les invitations.
+- Le **serveur MCP** (optionnel) doit être placé sur un réseau isolé ou derrière une authentification supplémentaire.
+- **Sauvegardes PostgreSQL** fréquentes (la base est la seule source de vérité).
+
+## Ressources
+- Documentation officielle : https://docs.baby-buddy.net/
+- Démo en ligne : https://demo.baby-buddy.net/ (admin/admin)
+- Dépôt GitHub : https://github.com/babybuddy/babybuddy
+- Image Docker : https://hub.docker.com/r/linuxserver/babybuddy
+- Serveur MCP : https://github.com/babybuddy/babybuddy-mcp
+- Intégration Home Assistant : https://github.com/jcgoette/baby_buddy
+
+## Pages Liées
+- [[cat-tracking]]
+- [[recettes-docker-compose]]