Skip to content

Getting Started

Language: English | Nederlands

Install

uv add python-appie

Or:

pip install python-appie

For local development in this repository:

uv sync --extra dev

Login

Run:

uv run appie-login

This opens Chrome and captures the AH login redirect code automatically. Tokens are stored in ~/.config/appie/tokens.json.

Expected outcome: - a browser window opens for AH login - after a successful login, tokens are stored locally - later package usage reuses those tokens automatically

First request

import asyncio

from appie import AHClient


async def main() -> None:
    async with AHClient() as client:
        products = await client.products.search("melk", limit=3)
        for product in products:
            print(product)


asyncio.run(main())

Expected outcome:

Product(id=...)
Product(id=...)
Product(id=...)

Read next: Authentication for token storage, refresh behavior, and re-login expectations.