wiki/Catalogue-Self-Hosted/apps/app-baby-buddy.md

---
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]]