# Install

Source: https://getanalog.io/docs/install/

One line on macOS, Linux, WSL, or Windows.

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.

<details class="reference-index">
<summary>On this page</summary>

- [Set up with a coding agent](https://getanalog.io/docs/install/#set-up-with-a-coding-agent)
- [Install from a terminal](https://getanalog.io/docs/install/#install-from-a-terminal)
- [Install in a Python project](https://getanalog.io/docs/install/#install-in-a-python-project)
- [The built-in browser](https://getanalog.io/docs/install/#the-built-in-browser)
- [Next steps](https://getanalog.io/docs/install/#next-steps)

</details>



## Set up with a coding agent

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](https://getanalog.io/agent-onboarding.md), or
install from a terminal below. For an app that uses MCP, follow the
[MCP setup guide](https://getanalog.io/docs/mcp/).



### Give your agent the setup instructions

```setup-prompt
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.
```





## Install from a terminal

Choose one installation method. The macOS/Linux/WSL and PowerShell
scripts install [`uv`](https://docs.astral.sh/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](https://getanalog.io/docs/install/#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

<!-- BEGIN GENERATED: onboarding sdk-install-shell -->

```bash example=runnable scenario=onboarding-sdk-install-shell
curl -LsSf https://getanalog.io/install | sh
```
<!-- END GENERATED: onboarding sdk-install-shell -->

### Windows PowerShell

<!-- BEGIN GENERATED: onboarding sdk-install-powershell -->

```powershell example=runnable scenario=onboarding-sdk-install-powershell
powershell -ExecutionPolicy ByPass -c "irm https://getanalog.io/install.ps1 | iex"
```
<!-- END GENERATED: onboarding sdk-install-powershell -->

### Already use uv

<!-- BEGIN GENERATED: onboarding sdk-install-uv -->

```bash example=runnable scenario=onboarding-sdk-install-uv
uv tool install analog-sdk
```
<!-- END GENERATED: onboarding sdk-install-uv -->

### Homebrew

```bash example=runnable scenario=sdk-install-homebrew
brew install getanalog/tap/analog
```

### pipx

```bash example=runnable scenario=sdk-install-pipx
pipx install analog-sdk
```



### Keep Analog up to date

`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.





## Install in a Python project

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](https://getanalog.io/docs/authenticate/) and
[run the Python example](https://getanalog.io/docs/extract/#in-python). If you already
connected an account as the same local user, Python uses that stored
credential too.



### Add the SDK to your environment

In an activated virtual environment with Python 3.10+:

```bash example=runnable scenario=python-project-install
pip install analog-sdk
```





## The built-in browser

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.



### Prepare the browser

This example has the browser already installed.

<!-- BEGIN GENERATED: onboarding browser-preinstall -->

```bash example=runnable scenario=onboarding-browser-preinstall-default
analog browser install
```
<!-- END GENERATED: onboarding browser-preinstall -->

```text wrap=true example=output scenario=onboarding-browser-preinstall-default
Ensuring Analog's browser (Chromium) is installed…
Analog's browser is ready.
```



## Next steps

Follow the [Quickstart](https://getanalog.io/docs/quickstart/#2-connect-your-account) to
connect an account and save your first result. Creating an account
during the private alpha requires an invite code.