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

# Install & authenticate

> Install the AX CLI, set up your Arize credentials, and add Arize Skills to Cursor, Claude Code, Codex, or Windsurf.

## Prerequisites

<Note>
  [`npx evals`](/docs/ax/set-up-with-ai-assistants#one-command-setup) does all of this for you: it installs the CLI, authenticates, and selects your space. Work through the steps below if you would rather set it up by hand.
</Note>

1. **AX CLI:**
   ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
   uv tool install arize-ax-cli   # or: pipx install arize-ax-cli
   ```

2. **Authentication** — set up your API key using one of these methods:

   <Tabs>
     <Tab title="ax profile (recommended)">
       ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
       # Interactive wizard
       ax profiles create

       # Or pass the key directly
       ax profiles create --api-key YOUR_API_KEY
       ```
     </Tab>

     <Tab title=".env file">
       ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
       cp .env.example .env
       # Edit .env with your credentials:
       # ARIZE_API_KEY=your-api-key
       # ARIZE_SPACE=my-workspace       # space name or base64 ID from ax spaces list
       ```

       Skills automatically load this file during their prerequisite check.
     </Tab>

     <Tab title="Environment variables">
       ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
       export ARIZE_API_KEY="your-api-key"
       export ARIZE_SPACE="my-workspace"   # space name or base64 ID from ax spaces list
       ```
     </Tab>
   </Tabs>

3. **Space** — `ARIZE_SPACE` accepts a space name (e.g. `my-workspace`) or base64 ID. Find yours with `ax spaces list` or from the Arize URL (`/spaces/{SPACE_ID}/...`).

4. **Verify:**
   ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
   ax --version && ax profiles show
   ```

See [AX CLI overview](/docs/api-clients/cli/overview) for full details.

## Install Skills

**Option 1: npx (recommended)**

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
# Interactive — choose skills, agent, and scope
npx skills add Arize-ai/arize-skills

# Non-interactive — install everything
npx skills add Arize-ai/arize-skills --skill '*' --yes
```

**Option 2: ax CLI**

If you already have `ax` installed (v0.9.0+):

```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
ax skills install
```

See the [`ax skills` reference](/docs/api-clients/cli/skills) for every flag.

**Option 3: Claude Code plugin**

```
/plugin marketplace add Arize-ai/arize-skills
/plugin install arize-skills@arize-skills
```

**Option 4: git clone**

<Tabs>
  <Tab title="macOS / Linux">
    ```bash theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    git clone https://github.com/Arize-ai/arize-skills.git
    cd arize-skills
    ./install.sh --project ~/my-project
    ```
  </Tab>

  <Tab title="Windows (PowerShell)">
    ```powershell theme={"theme":{"light":"github-light-default","dark":"github-dark-default"}}
    git clone https://github.com/Arize-ai/arize-skills.git
    cd arize-skills
    .\install.ps1 -Project ~\my-project
    ```
  </Tab>
</Tabs>

The installer auto-detects your agents and optionally installs the `ax` CLI. Use `--global` / `-Global` to install to `~/.<agent>/skills/`. Run `--list` to see available skills, `--uninstall` to remove them.

**Updating skills:** `npx skills update` or `cd arize-skills && git pull`.