Skip to content

docs(runner-setup): rewrite for the 5.2.x standalone runner - #2

Draft
paulsbrookes wants to merge 1 commit into
mainfrom
docs/runner-setup-5.2.x
Draft

docs(runner-setup): rewrite for the 5.2.x standalone runner#2
paulsbrookes wants to merge 1 commit into
mainfrom
docs/runner-setup-5.2.x

Conversation

@paulsbrookes

Copy link
Copy Markdown
Contributor

Problem

The runner-setup skill walks users through the Python 3.11 venv + tools-bundle installer path with download credentials. That path is now legacy: the runner ships as a self-contained standalone binary on a public download path, and the CLI surface changed in 5.x (the start interactive/start non-interactive subcommands were removed; a configure + registration-token flow and a self-update upgrade command were added).

Change

Rewrite the skill around the shipped 5.2.x runner (verified against 5.2.0, 2026-07-14), keeping the step-by-step, one-question-at-a-time guidance style:

  • Download the standalone binary from the public, no-auth path https://files.artemis.turintech.ai/public/artemis-runner/artemis-runner-latest-linux (Windows .exe too). -latest there tracks the newest release; no credentials needed.
  • Register with configure --url <deployment> --token <turin_reg_…> --runner-name <name> using the single-use token from the Web UI (Runners → Add new Artemis runner), then start. An API key remains a headless alternative (start --api-key).
  • Update in place with artemis-runner upgrade (per-deployment pre-release policy).
  • Advanced options (--no-delete-task-output, --worker-output-dir, --ram-limit-mb) documented.
  • The pip/venv path is retained only as a fallback for when the binary won't run.

Verification

All commands were checked against the actual 5.2.0 binary: --version, configure --help, start --help, upgrade --help, and confirmation that start non-interactive now errors (unexpected extra argument(s)). The public -latest-linux was confirmed byte-identical to artemis-runner-5.2.0-linux.

The runner-setup skill was entirely on the Python 3.11 venv + tools-bundle
installer path with download credentials. Rewrite it around the shipped 5.2.x
runner (verified against 5.2.0, 2026-07-14):

- Download the self-contained standalone binary from the public, no-auth path
  files.artemis.turintech.ai/public/artemis-runner/ (`-latest` tracks newest).
- Register via `configure --url --token` using the single-use registration
  token shown in the Web UI (Runners -> Add runner), then `start`. An API key
  works headlessly as an alternative.
- Add the self-update `artemis-runner upgrade` command and advanced-option
  flags; keep the pip/venv path only as a fallback for when the binary won't run.
@paulsbrookes
paulsbrookes marked this pull request as draft July 14, 2026 15:14
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant