analog-sdk 0.5.4

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.

Saved results

Every analog(url) call saves its result locally, so you can re-open or re-export it later — without re-fetching or re-rendering the page:

from analog import analog, history, latest

result = analog("https://example.com")
print(result.handle)        # "20260618-k7m2p9"

# Later — rehydrated from disk, no network:
again = latest()            # the most recent result
print(again.markdown)       # full-page markdown, stored alongside the data
for meta in history():      # everything saved, newest first
    print(meta.handle, meta.url)

Re-open a specific result with analog.open(handle). Artifacts live under your per-user cache directory (~/.cache/analog/results; ~/Library/Caches/analog/results on macOS; ANALOG_CACHE_DIR overrides) and store only safe derivatives — the structured result and full-page markdown, never raw HTML. Pass analog(url, save=False) to skip saving; the store is size-bounded and drops least-recently-opened results.

From the shell, analog get <url> saves and prints the handle, and analog history / analog open <handle> / analog export <handle> -f csv / analog rm <handle> manage saved results (latest works anywhere a handle does).

License

MIT — see LICENSE.