> ## Documentation Index
> Fetch the complete documentation index at: https://docs.artifacta.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Installation

> Install the Artifacta CLI and Python SDK.

## Install

<CodeGroup>
  ```bash pip (recommended) theme={null}
  pip install artifacta-cli
  ```

  ```bash Homebrew theme={null}
  brew install artifacta/tap/artifacta
  ```

  ```bash curl theme={null}
  curl -fsSL https://get.artifacta.io | sh
  ```
</CodeGroup>

<Info>
  `pip install artifacta-cli` installs **both** the CLI binary and the Python SDK.
  You get `artifacta` on your PATH and `from artifacta import Client` in Python.
</Info>

## Requirements

| Method   | Requires                      |
| -------- | ----------------------------- |
| pip      | Python 3.10+                  |
| Homebrew | macOS or Linux with Homebrew  |
| curl     | macOS or Linux (amd64, arm64) |

## Verify installation

```bash theme={null}
artifacta --version
```

```text Output theme={null}
artifacta, version 0.2.0
```

## Upgrade

<CodeGroup>
  ```bash pip theme={null}
  pip install --upgrade artifacta-cli
  ```

  ```bash Homebrew theme={null}
  brew upgrade artifacta
  ```

  ```bash curl theme={null}
  curl -fsSL https://get.artifacta.io | sh
  ```
</CodeGroup>

## What's included

| Component      | What you get                                                                                                                                         |
| -------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------- |
| **CLI**        | `artifacta push`, `pull`, `ls`, `inspect`, `link`, `rm`, `session`, `whoami`, `auth`, `config`                                                       |
| **Python SDK** | `from artifacta import Client` — `push()`, `pull()`, `pull_bytes()`, `push_dict()`, `list()`, `get()`, `delete()`, `create_link()`, `seal_session()` |

Both share a codebase and are always installed together. There is no separate CLI-only or SDK-only package.