Baby Buddy (Imperial / lbs & oz Fork)

This is a fork of babybuddy/babybuddy with modifications to default weight tracking to pounds and ounces (lbs/oz) instead of kilograms. See Changes from upstream below for full details.

A buddy for babies! Helps caregivers track sleep, feedings, diaper changes, tummy time and more to learn about and predict baby's needs without (as much) guess work.

🔧 Changes from upstream

This fork modifies the official Baby Buddy project in the following ways:

Weight tracking in lbs & oz

• Default weight unit is pounds and ounces (lbs/oz) for all new users. Kilograms remain available as a per-user setting under User Settings → Weight Unit.
• Weight entry uses two separate fields — Pounds and Ounces — so you never need to do decimal conversions. Just type 13 lbs and 7 oz.
• Weight is stored as total ounces internally (e.g. 13 lbs 7 oz = 215 oz), which avoids floating-point rounding issues with values like 10–15 oz.
• Weight lists and graphs display values in the format X lbs Y oz when lbs/oz is selected.

Migrating from the official image? If your existing weight entries were recorded in the legacy lbs.oz decimal format (e.g. 13.7 to mean 13 lbs 7 oz), the included database migration (core/0036) will automatically convert them to the new total-ounces format on first run.

Docker / self-hosting

A Dockerfile and babybuddy/settings/docker.py are included so you can build and run this fork directly from source without relying on the upstream Docker Hub image.

Quick start with Docker Compose — replace the official image reference:

services:
  babybuddy:
    build:
      context: /path/to/your/cloned/babybuddy  # e.g. /home/youruser/babybuddy
      dockerfile: Dockerfile
    image: babybuddy-local:latest
    environment:
      - DJANGO_SETTINGS_MODULE=babybuddy.settings.docker
      - SECRET_KEY=your-secret-key-here
      - DB_ENGINE=django.db.backends.postgresql
      - DB_NAME=babybuddy
      - DB_USER=youruser
      - DB_PASSWORD=yourpassword
      - DB_HOST=babybuddy-db
      - DB_PORT=5432
      - CSRF_TRUSTED_ORIGINS=https://yourdomain.com
    volumes:
      - ./media:/app/media
    ports:
      - "8000:8000"

Migrations (including the weight conversion) run automatically on container startup.

---

👾 Demo

A demo of Baby Buddy is available. The demo instance resets every hour. Login credentials are:

• Username: admin
• Password: admin

📘 Documentation

Visit https://docs.baby-buddy.net for full documentation.

Additional documentation

• Security
• License (BSD-2 Clause)

🗺️ Languages

Baby Buddy is available in a variety of languages thanks to the efforts of numerous translators. Language can be set on a per-user basis from the user settings page (/user/settings/). See Contributing for information about how to create/update translations.

Available languages

🇧🇷 Brazilian Portuguese, 🇪🇸 Catalan, 🇨🇳 Chinese (simplified), 🇭🇷 Croatian, 🇨🇿 Czech, 🇩🇰 Danish, 🇳🇱 Dutch, 🇬🇧 English (U.K.), 🇺🇸 English (U.S.) (base), 🇫🇮 Finnish, 🇫🇷 French, 🇩🇪 German, 🇮🇱 Hebrew, 🇭🇺 Hungarian, 🇮🇹 Italian, 🇯🇵 Japanese, 🇳🇴 Norwegian Bokmål, 🇵🇱 Polish, 🇵🇹 Portuguese, 🇷🇺 Russian, 🇷🇸 Serbian, 🇲🇽 🇪🇸 Spanish, 🇸🇪 Swedish, 🇹🇷 Turkish, 🇺🇦 Ukrainian

🌐 Baby Buddy on the Web

This is a non-exhaustive list of neat projects and blog posts that either extend or use Baby Buddy in fun ways. If you have a project to share please open a PR adding it here or reach out via GitHub Issues or Discussions or on Gitter!

Smart home

• Home Assistant Addon (host Baby Buddy on Home Assistant)
• Home Assistant integration (monitor and use Baby Buddy from Home Assistant)
• How to Setup Baby Buddy in Home Assistant
• Baby Buddy and Home Assistant
• Alexa skill

Hardware

• Bottle Scale for BabyBuddy and Home Assistant with ESPHome
• Quick Entry Keypad (ESP8266)
• Baby Buddy Keypad (ESP32)
• BabyScout - Keypad for recording diaper changes, feedings and sleep to BabyBuddy
• BabyPod - A remote control for Baby Buddy for new parents (sources: hardware, software)
• MatrixPortal BabyBuddy

Mobile

• Baby Buddy for Android (Source)
• iOS shortcuts
• Convert exported data from "Baby tracker - feeding, sleep and diaper" mobile app to Baby Buddy

Videos

• Baby Buddy: Keep Records of Your Child/Baby's Growth and Activities

Other

• Grafana Dashboard
• Sandstorm app
• Newborn parenting software series (API, buttons, LCD information screen!)
  • part 1
  • part 2
  • part 3
• High Level Developer Documentation (AI-Generated)
• Example custom TypeScript frontend (based on Remix)

🔐 Reporting Vulnerabilities

See SECURITY.md for information about where and how to report potential Baby Buddy vulnerabilities.

❤️ Support

Contribution and sponsorship

Contribute or sponsor Baby Buddy's contributors using any of the following methods:

• Sponsor @babybuddy on GitHub
• Sponsor @cdubz on GitHub
• Contribute on Open Collective

Tools and infrastructure

The following organizations and services support Baby Buddy contributors in various ways (software licensing, service credits, etc.).

Some of the links below use referral codes -- all referral proceeds are treated as contributions to the Baby Buddy project.