Agent

Agent is the WaveGrid process that runs on your infrastructure. It queries providers through plugins and pushes normalized resource snapshots to the console.

Provider credentials (Proxmox, Hetzner, AWS, …) never leave your network. The platform only receives resource metadata and a tenant API token.

Getting started

1. Install the agent (Docker Hub is the default path; a wheel is the fallback). Files and versions are on Releases.
2. Connect the workspace: tenant_id, api_url, tenant_token.
3. Install plugins from the catalog and add provider access.
4. Confirm the agent is online in the app: Inventory → Agents.

Screens of the built-in editor (Configuration, Plugins, Marketplace, Operations) are on local UI, with screenshots.

Plugins are optional for the first heartbeat: without them the agent still shows as online (empty sync).

How it fits

Your infrastructure

WaveGrid

ProvidersProxmox · Prometheus · …

Pluginswheels from the catalog

AgentYAML: secrets stay herelocal UI :8765

POST /api/v1/sync/

HTTPS · snapshots only

Inventoryresources from the agent

Console · costs · alerts

The agent is not installed on the SaaS VPS. The local UI on :8765 is only a config editor on your network — do not expose it to the internet.