**Track prices from the stores you actually use. Run it yourself. Keep the data. Know when a deal is real.** PriceBuddy is an open source, self-hostable price tracker for people who would rather watch products than browser tabs. Paste in a product URL, let PriceBuddy check it on a schedule, and get notified when the price or availability moves in your favour. It works across different stores, keeps price history, compares listings, handles stock status, and can use your own AI provider when a page is awkward to scrape. The web app is the main control room; the API and CLI make it scriptable. [Read the docs](https://pricebuddy.jez.me?ref=pb-gh) · [Install with Docker](#installation) · [Explore features](#features) · [CLI](https://github.com/jez500/pricebuddy-cli) ![Dashboard](docs/docs/.vuepress/public/screenshots/dashboard.png) ## Why PriceBuddy? Most price trackers work only where someone has already built an integration. PriceBuddy is built for the messy web: normal product pages, changing markup, multiple listings for the same item, stores that go in and out of stock, and the usual "sale" prices that are not really sales. Use it for everyday shopping, household wishlists, hobby gear, computer parts, baby stuff, subscriptions, marketplace listings, or anything else where timing matters. ## Features ### Track almost any store Paste a product URL and PriceBuddy will try to read the product title, image, price and availability. Many stores work straight away. For trickier sites, you can tune the scrape strategy without changing code. ### Compare listings across retailers Track the same product across multiple stores, or multiple listings on the same marketplace, and see the current best option in one place. ### Keep the price history PriceBuddy records prices over time so you can see highs, lows and trends. That makes it easier to spot fake discounts and decide whether today's price is actually good. ### Get notified where you already are Set a target price or percentage drop and let PriceBuddy watch for it. Notifications can go through the app, email, Pushover, Gotify, Apprise, Telegram, Discord or ntfy. ### Track availability, not just price A cheap listing is useless if it is out of stock. PriceBuddy tracks in stock, pre-order, back order, special order, out of stock and discontinued states. ### Compare unit prices PriceBuddy can calculate price per unit, so a 10-pack and a 3-pack can be compared fairly. ### Use AI only when it helps Bring your own OpenAI, Anthropic, Gemini or local Ollama provider. PriceBuddy can use AI to recover missing data from a page or help repair scraping rules. It is optional and off by default. ### Search for products to track Connect a [SearXNG](https://github.com/searxng/searxng) instance and search for products from inside PriceBuddy. ### Organise a shared watchlist Use tags, filters and multi-user accounts so each person can track their own products, targets and notification preferences. ### Host it yourself Run PriceBuddy on your own server with Docker. Your watchlist, price history and notification settings stay under your control. ## PriceBuddy tools PriceBuddy is designed to be useful from more than the web UI. The tool ecosystem is small for now, with more planned. | Tool | What it is for | | --- | --- | | [PriceBuddy CLI](https://github.com/jez500/pricebuddy-cli) | Command-line access for humans and agents. Sync a local mirror, search products, inspect price history, run deal/drop reports, call the REST API, and expose PriceBuddy through MCP. | A browser extension is planned. ## Screenshots | Product overview | Price history | | --- | --- | | ![Product](docs/docs/.vuepress/public/screenshots/product.png) | ![History](docs/docs/.vuepress/public/screenshots/history.png) | ## Installation All you need is [Docker](https://www.docker.com/). Download [docker-compose.yml](docker-compose.yml), adjust it for your environment, then start PriceBuddy: ```shell touch .env docker compose up -d ``` With the defaults, the app runs at `http://localhost:8080`. Default login: ```text admin@example.com / admin ``` Change that password immediately. See the [installation guide](https://pricebuddy.jez.me/installation.html) for the full setup and configuration options. > Docker is the recommended install path. If you want to run it another way, `docker/php.dockerfile` and `docker-compose.yml` are the best references for the required services and PHP extensions. ## Background tasks The Docker image includes the scheduler needed for background work: checking prices, updating history and sending notifications. You do not need to run a separate cron container. ## Settings and configuration Most settings live in the app. Advanced options can be set in `.env`. See the [settings docs](https://pricebuddy.jez.me/settings.html) for details. ## Affiliate codes PriceBuddy adds affiliate codes for a [small number of stores](config/affiliates.php) to help support development. If you do not want that, set this in `.env` or `docker-compose.yml`: ```env AFFILIATE_ENABLED=false ``` If you disable affiliate support and still want to help, see [supporting the project](https://pricebuddy.jez.me/support-project.html). ## Inspiration PriceBuddy was inspired by [Discount Bandit](https://github.com/Cybrarist/Discount-Bandit). PriceBuddy's main difference is flexibility: it aims to track products from arbitrary stores without requiring a code change for each retailer. ## Contributing and development Contributions are welcome. Open an issue or pull request if you have a bug fix, store compatibility improvement, documentation change or feature idea. PriceBuddy is built with [Laravel](https://laravel.com) and [Filament](https://filamentphp.com). Local development uses [Lando](https://lando.dev): ```shell lando start ``` Coding standards, static analysis and tests are handled with Pint, PHPStan and Pest/PHPUnit. See the [development docs](https://pricebuddy.jez.me/advanced.html) for the full setup. ## Supporting development See [supporting the project](https://pricebuddy.jez.me/support-project.html) for ways to help keep PriceBuddy moving. ## License See [LICENSE.md](LICENSE.md). ## Contributors - [Jeremy Graham](https://jez.me)