analog-sdk 0.5.0

Python SDK for Analog — instantly distill webpages into structured data.

analog-sdk

Python SDK for Analog — instantly distill webpages into structured data.

Installation

pip install analog-sdk

For JS-heavy pages (single-page apps, infinite scroll, content that hydrates client-side), also install the companion fetcher:

pip install "analog-sdk[fetcher]"

This gives you the AnalogFetcher, which is used as the default automatically — cheap HTTP fetch on first contact, escalates to a Playwright-rendered fetch only when the page actually needs it, and caches the decision per-domain so subsequent visits skip the probe.

Authenticate

New to Analog? analog signup opens the account-creation page (invite code required during the private alpha). Then:

analog login

This opens your browser to sign in. The credential is minted straight into a local store and never shown on screen, so the model driving your session never sees it. Subsequent SDK and CLI usage picks it up automatically; sign out any time with analog logout.

Signing in requires a browser on the machine running analog login.

Try it straight from the shell:

analog get https://news.ycombinator.com

Run analog --help to see all commands (signup, login, logout, whoami, status, get).

If you don't want a globally-installed analog binary, use pipx install analog-sdk or uv tool install analog-sdk instead of plain pip install.

Usage

from analog import analog

result = analog("https://example.com")

Same one-liner whether or not the JS-aware fetcher is installed. When it is, JS-heavy pages just work.

See https://getanalog.io for full documentation.

License

MIT — see LICENSE.