Skip to content

Install

View as Markdown

Install the analog command for terminal use, or add the SDK to a Python project. Choose the route that fits where you want to use Analog.

On this page

Copy this prompt into a coding agent that can run commands on your machine. It checks the existing setup and completes the steps that apply.

You can read the agent setup instructions, or install from a terminal below. For an app that uses MCP, follow the MCP setup guide.

Give your agent the setup instructions

Set up Analog in this environment using
https://getanalog.io/agent-onboarding.md.
Check the existing setup and complete the steps that apply.
Use my agent's browser when it can supply a capture; otherwise use Analog's browser.
Verify it by finding Frankie on https://getanalog.io/about/ and searching the saved result again.
Tell me when a step needs my participation.

Choose one installation method. The macOS/Linux/WSL and PowerShell scripts install uv if needed, then install Analog as an isolated tool with the analog command on your PATH.

If you already use uv, Homebrew, or pipx, choose that command instead. These methods install the terminal app; to import Analog in a program, use Install in a Python project.

Analog needs Python 3.10+. The scripts use uv so it can supply a compatible managed Python. With pipx, use a Python 3.10+ interpreter.

macOS, Linux, and WSL

curl -LsSf https://getanalog.io/install | sh

Windows PowerShell

powershell -ExecutionPolicy ByPass -c "irm https://getanalog.io/install.ps1 | iex"

Already use uv

uv tool install analog-sdk

Homebrew

brew install getanalog/tap/analog

pipx

pipx install analog-sdk

analog update upgrades Analog through whichever channel installed it. In a pip-managed virtualenv it prints the exact command instead of running it — that environment’s dependencies are its manager’s call.

To import Analog from Python, install analog-sdk in the environment that runs your program. The terminal installer creates an isolated CLI tool; a Python project needs its own dependency.

Then connect an account and run the Python example. If you already connected an account as the same local user, Python uses that stored credential too.

In an activated virtual environment with Python 3.10+:

Add the SDK to your environment

pip install analog-sdk

When you use analog browse, Analog uses a headless browser to run the page’s JavaScript and capture what it renders. Browser binaries download automatically when needed. Download size varies by platform and browser version.

Download them ahead of time in CI or an agent harness when you want the browser ready before the first call. This step is optional; it is safe to rerun if the browser is already installed.

Prefer a plain HTTP GET with no JS? Pass fetcher=HttpFetcher() in Python.

This example has the browser already installed.

Prepare the browser

analog browser install
Output
Ensuring Analog's browser (Chromium) is installed…
Analog's browser is ready.

Follow the Quickstart to connect an account and save your first result. Creating an account during the private alpha requires an invite code.