kaloricketabulky-sdk

Typesafe, async, read-only access to the kaloricketabulky.cz internal API. The SDK layer (kaloricketabulky.sdk) depends only on httpx and pydantic and can be used on its own; the surrounding package adds configuration and a command-line entry point.

Unofficial — be a respectful guest

The site has no official public API; this is an unofficial client built against the endpoints the web app uses. Use it for your own data only, keep your polling slow and infrequent, and don't be a dick about it. If you get value out of kaloricketabulky.cz, please support them with a subscription.

Install

uv add kaloricketabulky-sdk

At a glance

import asyncio
from datetime import date

from kaloricketabulky.sdk import KaloricketabulkyClient, SnapshotType


async def main() -> None:
    async with KaloricketabulkyClient() as client:
        await client.login("you@example.com", "password")
        diary = await client.get_diary(date(2026, 6, 2))
        print(diary.energy_total)


asyncio.run(main())

See Usage for the full surface, and the API reference in the navigation for every model.