# Project pack: Baby Buddy @ 09629cf

Facts about **Baby Buddy** for an AI following the [BespokeAI handover guide](https://handoff.bespokeai.software/guide/v4.md). Pinned to one version; never changes after publication.

> Baby Buddy helps new parents and carers keep track of feeds, sleep, nappy changes, tummy time, medicine, weight and more. Timers make it quick to log things at 3am, and charts show patterns over days and weeks, so you can see when your baby is likely to be hungry or tired. Everyone who looks after the baby can share it. It runs on your own computer or server, so your family's data stays private.

## Setup path (checked 2026-11-03)
- **Needs Docker.** Tell the person before any setup work; no light non-Docker route is documented upstream. Docker Desktop on Windows may need a computer restart and an admin-only Windows feature (virtualisation); say so and let the person decide.
- Verdict source: https://docs.baby-buddy.net/setup/deployment/
- You may be unable to download source archives or run commands in this session. The person downloads and runs things; if you cannot fetch something, give any changed file in full in chat with its path.

## Version and source
- Repository: https://github.com/babybuddy/babybuddy
- Pinned commit: `09629cf633cf3a2059a21ade4cea7ea4d846422f`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/babybuddy/babybuddy/archive/09629cf633cf3a2059a21ade4cea7ea4d846422f.zip
- Fresh checkout (only if you have a shell and git): use the commands below in an empty folder. If this exact source is already checked out, keep your branch and use the development command; do not clone again or reset local changes.
- Official docs: https://docs.baby-buddy.net
- Live demo: https://demo.baby-buddy.net (username: admin / password: admin). Public demo; it resets every hour. Don't enter real data.
- Licence: **BSD-2-Clause**. Free to use, change and share for any purpose, including commercially. Just keep the copyright notice and licence text with the code. You don't have to publish your changes.

## Commands from the pinned source
- Developer commands (they may use Docker):

  ```sh
  git clone https://github.com/babybuddy/babybuddy bespoke-babybuddy
  cd bespoke-babybuddy
  git checkout --detach 09629cf633cf3a2059a21ade4cea7ea4d846422f
  # Prepare development requirements and local configuration first.
  # Setup notes: http://127.0.0.1:8000, admin / admin
  pipenv install --dev && npm install && export DJANGO_SETTINGS_MODULE=babybuddy.settings.development && gulp migrate && gulp
  ```

- Separate trial of the current upstream release (not your changes; sample data and a separate data directory only):

  ```sh
  docker run -d --name babybuddy -p 8000:8000 -v babybuddy-config:/config --restart unless-stopped lscr.io/linuxserver/babybuddy # then open http://localhost:8000, log in as admin / admin and change the password straight away
  ```
- Tools these commands use: Docker, or for development Python 3.10+ with pipenv, Node.js 24 with npm, and gulp-cli (or use the included dev container)
- Develop: `pipenv install --dev && npm install && export DJANGO_SETTINGS_MODULE=babybuddy.settings.development && gulp migrate && gulp   # http://127.0.0.1:8000, admin / admin`
- Test: `gulp test`
- Check/lint: `gulp lint`
- Stack: python, javascript, html, scss (Django 5, Django REST Framework, Bootstrap 5, Plotly, Gulp). Difficulty for a non-developer with an AI: **easy**. A classic Django project with server-rendered templates and a few small apps (core, dashboard, reports, api, webhooks). Most changes are a model, a view, a template, a dashboard card or a chart. Gulp builds the styles and runs the dev server.
Personal data: **yes**. Stored in: SQLite database and uploaded photos in the /config volume (Docker); PostgreSQL or MySQL optional. Secrets are entered by the person, never in chat.

---
Later, only when a step needs it: [reference.md](https://handoff.bespokeai.software/p/babybuddy/09629cf/r3/reference.md) (customisation points, must-keep-working, data and costs, coding conventions) · [hosting.md](https://handoff.bespokeai.software/p/babybuddy/09629cf/r3/hosting.md) (long-term hosting; hosts are paid third parties) · [bespoke.yaml](https://handoff.bespokeai.software/p/babybuddy/09629cf/r3/bespoke.yaml) · [SKILL.md](https://handoff.bespokeai.software/p/babybuddy/09629cf/r3/SKILL.md)