# Project pack: Grocy @ 41206cb

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

> Grocy helps you run your household. It keeps track of the food in your fridge and cupboards and warns you before things go out of date. It builds your shopping list from what is running low, plans meals from your recipes, and reminds you about chores, tasks and batteries. It runs on your own computer or server, or as a simple Windows app.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install the project's own desktop app or installer. No Docker.
- Offer Docker only if the person asks or this path fails. The commands further down may use Docker; they are not the starting point.
- Verdict source: https://raw.githubusercontent.com/grocy/grocy/HEAD/README.md
- 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/grocy/grocy
- Pinned commit: `41206cb90154e0d17d3e108cc1f182b94fdb465d`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/grocy/grocy/archive/41206cb90154e0d17d3e108cc1f182b94fdb465d.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.
- Live demo: https://demo.grocy.info. Public demo of the latest stable release, filled with example data and no login. Shared with everyone, so don't enter anything private.
- Licence: **MIT**. Free to use, change and share, even commercially. Keep the copyright and licence notice when you share it. No other obligations.

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

  ```sh
  git clone https://github.com/grocy/grocy bespoke-grocy
  cd bespoke-grocy
  git checkout --detach 41206cb90154e0d17d3e108cc1f182b94fdb465d
  # Prepare development requirements and local configuration first.
  # Setup notes: then point a web server (or php -S localhost:8080 -t public) at the public folder
  composer install && yarn install && cp config-dist.php data/config.php
  ```

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

  ```sh
  docker run -d --name grocy -e PUID=1000 -e PGID=1000 -e TZ=Europe/London -p 9283:80 -v grocy-config:/config lscr.io/linuxserver/grocy:latest
  # community image by LinuxServer.io (linked from the README); open http://localhost:9283,
  # log in as admin / admin and change the password straight away
  ```
- Tools these commands use: Docker, or PHP 8.5 with SQLite 3.40+ and a web server; Grocy Desktop for Windows
- Develop: `composer install && yarn install && cp config-dist.php data/config.php   # then point a web server (or php -S localhost:8080 -t public) at the public folder`
- Stack: php, javascript, css (Slim 4, Blade templates, Bootstrap 4, jQuery). Difficulty for a non-developer with an AI: **moderate**. Plain PHP (Slim and Blade) with jQuery page scripts and one SQLite file, with no front-end build step. Almost everything can be switched on or off with settings and feature flags. Upstream does not accept code contributions, so code changes stay in your own copy.
Personal data: **yes**. Stored in: One SQLite database in the data folder (inside the /config volume in the LinuxServer Docker image), plus uploaded pictures and data/config.php. Secrets are entered by the person, never in chat.

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