Skip to content

Installation

AmiPilot has no installer: copy the files into place and they work.

Requirements

AmiInspect and AmiPilotServer (the two on-Amiga binaries this release ships):

  • AmigaOS 2.04 (V37) or later — the floor every API either binary calls actually needs (commodities-era Intuition, BOOPSI, input.device). See the implementation plan for the full rationale.
  • Plain 68000, no FPU. Nothing in this release does float work or needs anything newer than a stock CPU.
  • No meaningful RAM floor of its own — both are small Shell commands with no persistent state; the real floor is whatever application you're pointing them at.
  • AmiPilotServer additionally needs rexxsyslib.library (it fails outright without it — there's no point running with no ARexx port) and a resident RexxMast for scripts to reach it through rx. See the ARexx Reference.

Recommended / what this release is actually tested against: AmigaOS 3.1 or later, 68020, 2 MB chip + 8 MB fast. gadtools.library (any version) is optional but recommended for both binaries — without it open, the walker can't distinguish a GadTools checkbox from a plain button (both produce the same underlying gadget type; see Locator Tiers and Limits). AmiPilotServer also opportunistically opens keymap.library — without it, its TYPE command fails outright, but TREE/CLICK/GETTEXT still work.

Installing

Download amipilot.lha from the GitHub release, extract it, and copy AmiInspect and AmiPilotServer to C: (or anywhere on your command Path). The archive also carries this documentation as amipilot.guide (AmigaGuide/MultiView) and the license.

That's it — no reboot, no configuration. Run them from a Shell:

> AmiInspect
> Run AmiPilotServer

If you'd rather build it yourself than use the released binary, see Building and Testing (make dist produces the same archive this release ships).

Installing the host Python package

If you're driving AmiPilot from a host machine over the wire (serial or TCP) rather than only from on-Amiga ARexx scripts, you also need the amipilot Python package (the wire client, object API, amipilot dump, and the pytest plugin — see Wire Protocol). It isn't in the .lha release archive above (that's on-Amiga binaries only) — install it from a clone of this repository:

git clone https://github.com/sidick/amipilot.git
pip install -e 'amipilot/host/[test]'

Requires Python 3.9+. [test] pulls in pytest and the plugin's own test extras — drop it for a bare runtime-only install (pip install -e amipilot/host/) if you're not running the pytest plugin. There's no PyPI package yet; installing from a clone is the only path today.

Checking which version you have

Both binaries embed a standard AmigaDOS $VER: cookie — check it with the Shell's own Version command:

> Version AmiInspect
AmiInspect x.y

> Version AmiPilotServer
AmiPilotServer x.y

(x.y will be the actual release version, e.g. 1.0 — shown genericized here so this example doesn't go stale every release; see the Changelog for what's current.)

Next steps

Continue with Getting Started for a first inspection walkthrough.