Metadata-Version: 2.4
Name: gridfleet-agent
Version: 0.2.1
Summary: GridFleet agent — runs on each host
Project-URL: Homepage, https://github.com/quidow/gridfleet
Project-URL: Repository, https://github.com/quidow/gridfleet
Project-URL: Documentation, https://github.com/quidow/gridfleet/tree/main/docs
Project-URL: Issues, https://github.com/quidow/gridfleet/issues
Project-URL: Security, https://github.com/quidow/gridfleet/security/advisories/new
Author: GridFleet contributors
License-Expression: Apache-2.0
Keywords: appium,gridfleet,selenium,testing
Classifier: Development Status :: 3 - Alpha
Classifier: Framework :: FastAPI
Classifier: Intended Audience :: System Administrators
Classifier: License :: OSI Approved :: Apache Software License
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3.12
Classifier: Typing :: Typed
Requires-Python: >=3.12
Requires-Dist: fastapi==0.136.1
Requires-Dist: httpx==0.28.1
Requires-Dist: packaging>=26.2
Requires-Dist: psutil==7.2.2
Requires-Dist: pydantic-settings==2.14.0
Requires-Dist: uvicorn[standard]==0.46.0
Provides-Extra: dev
Requires-Dist: mypy>=1.20.2; extra == 'dev'
Requires-Dist: pytest-asyncio>=0.23; extra == 'dev'
Requires-Dist: pytest-cov>=6.0; extra == 'dev'
Requires-Dist: pytest>=9.0.3; extra == 'dev'
Requires-Dist: ruff>=0.15.12; extra == 'dev'
Description-Content-Type: text/markdown

# GridFleet Agent

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

## Quick Install

```bash
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](https://docs.astral.sh/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:

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

Install without starting the service:

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

Install and start the service:

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

Check installation status:

```bash
gridfleet-agent status
```

Upgrade to a specific version:

```bash
gridfleet-agent update --to 0.3.0
```

Or upgrade via uv directly:

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

Uninstall (requires confirmation):

```bash
gridfleet-agent uninstall --yes
```

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