# Project pack: changedetection.io @ 352b036

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

> changedetection.io watches websites for you and tells you when something changes. Use it for prices, stock, news, appointment slots, government notices and more. It highlights exactly what changed, can wait for a page to load like a real browser, and sends alerts to email, chat apps and over 80 other services.

## Setup path (checked 2026-11-03)
- **Start here, no Docker:** Install it with its language package manager. 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/dgtlmoon/changedetection.io/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/dgtlmoon/changedetection.io
- Pinned commit: `352b036217e32d3622f282f49bebcdb89592a28c`. Use exactly this version.
- Zip the person can download in a browser: https://github.com/dgtlmoon/changedetection.io/archive/352b036217e32d3622f282f49bebcdb89592a28c.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://github.com/dgtlmoon/changedetection.io/wiki
- Licence: **Apache-2.0**. Free to use, change and share, even commercially. Keep the licence and copyright notices, and note your changes. It includes a patent licence.

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

  ```sh
  git clone https://github.com/dgtlmoon/changedetection.io bespoke-changedetection
  cd bespoke-changedetection
  git checkout --detach 352b036217e32d3622f282f49bebcdb89592a28c
  # Prepare development requirements and local configuration first.
  pip install -r requirements.txt
  python3 changedetection.py -d ./datastore -p 5000
  ```

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

  ```sh
  docker run -d --restart always -p "127.0.0.1:5000:5000" -v changedetection-data:/datastore --name changedetection.io dgtlmoon/changedetection.io
  # then open http://localhost:5000
  ```
- Tools these commands use: Docker for a trial, Python 3.10+ for development
- Develop: `python3 changedetection.py -d ./datastore -p 5000`
- Test: `pytest`
- Stack: python, javascript (Flask, Playwright, Apprise). Difficulty for a non-developer with an AI: **easy**. A Flask app with a clear folder per feature. Watches, filters and notifications are settings; new processors or notification options are small additions.
Personal data: **no**. Stored in: JSON files and saved snapshots in the datastore folder. Secrets are entered by the person, never in chat.

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