# Artemis Runner Bundle (Wheels)

This bundle ships the artemis-runner Python wheel and its dependency wheels.
It is the fallback distribution for hosts not covered by the prebuilt
PyInstaller binaries — Linux on ARM, macOS, and any other platform with a
working Python 3.11+ install.

If you are on Linux x86_64 or Windows x86_64, prefer the platform-specific
binary bundle (`artemis-runner-<version>-linux.tar.gz` or
`artemis-runner-<version>-windows.zip`) — it has no runtime dependencies.

## Bundle Contents

```
artemis-runner-<version>-wheels/
  README.md
  wheels/
    artemis_runner-<version>-py3-none-any.whl
    artemis_client-...whl
    artemisopt-...whl
    optuna-...whl
    ...
```

## Prerequisites

- Python 3.11 (or any version satisfying `>=3.9, <3.14`)
- `pip` and `venv` available

## Install

```sh
# 1. Download and extract the bundle
curl -L -o artemis-runner.tar.gz \
  https://files.artemis.turintech.ai/public/artemis-runner/artemis-runner-latest-wheels.tar.gz
tar -xzf artemis-runner.tar.gz
cd artemis-runner-*-wheels

# 2. Create a virtualenv and install
python3.11 -m venv .venv
source .venv/bin/activate
pip install --upgrade pip
pip install --find-links wheels/ artemis-runner

# 3. Run it
artemis-runner --help
```

On Windows replace `python3.11` with `py -3.11` and `source .venv/bin/activate`
with `.venv\Scripts\activate`.

## Configuration, SSL, and Proxy Settings

The runner's configuration, SSL verification, and proxy settings work
identically across all bundle formats — see the main bundle README
(`docs/bundle.md` in the source tree, or the README inside the
`linux`/`windows` PyInstaller bundles) for the full reference.
