gridfleet-agent 0.3.0

GridFleet agent — runs on each host

GridFleet Agent

gridfleet-agent is the host-side service package for GridFleet device hosts.

Quick Install

curl -LsSf https://raw.githubusercontent.com/quidow/gridfleet/main/scripts/install-agent.sh | sh -s -- \
  --manager-url http://manager.example.com:8000

This installs uv if missing, fetches Python 3.12 automatically, and sets up the agent as a system service. No pre-installed Python version required.

Commands

Preview what the installer will do without writing files:

gridfleet-agent install --dry-run --manager-url http://manager.example.com:8000

Install without starting the service:

gridfleet-agent install --no-start --manager-url http://manager.example.com:8000

Install and start the service:

gridfleet-agent install --start --manager-url http://manager.example.com:8000

Check installation status:

gridfleet-agent status

Upgrade to a specific version:

gridfleet-agent update --to 0.3.0

Or upgrade via uv directly:

uv tool upgrade gridfleet-agent
sudo systemctl restart gridfleet-agent  # Linux
launchctl kickstart -k gui/$(id -u)/com.gridfleet.agent  # macOS

Uninstall (requires confirmation):

gridfleet-agent uninstall --yes

Use --keep-config or --keep-agent-dir to preserve local configuration or runtime state.