autogroceries 2.0.0

Automate your grocery shop.

autogroceries

autogroceries simplifies grocery shopping from Sainsbury's by using Playwright to automate the addition of ingredients to your basket.

Installation

I recommend using uv to manage the python version, virtual environment and autogroceries installation:

uv venv --python 3.13
source .venv/bin/activate
uv pip install autogroceries
# Install Chromium browser binary required for playwright.
playwright install chromium

Usage

autogroceries uses Playwright to interface with the Sainsbury's website, automatically filling your cart with an inputted list of ingredients.

The below demonstrates how to run autogroceries:

from autogroceries.shopper.sainsburys import SainsburysShopper

ingredients = {"milk": 1, "egg": 2}

# Store credentials securely e.g. in environment variables (use python-dotenv).
shopper = SainsburysShopper(
        username=os.getenv("SAINSBURYS_USERNAME"),
        password=os.getenv("SAINSBURYS_PASSWORD"),
    )

shopper.shop(
    {"cereal": 1, "tomatoes": 1, "lemon": 2, "salad": 1, "grapefruit": 3}
    )

The video below demonstrates how Playwright automates grocery shopping when running the example code above:

Your browser does not support the video tag.