Agent Setup

Deploying the Resonance Agent

Follow these steps to install and tune the Resonance agent in your environment. Once completed, you can stream real traffic, build history, and unlock the full suite of Resonance Calculus dashboards.

1. Provision the agent host

Choose a Linux or macOS host with outbound HTTPS access. Allocate at least 2 vCPU, 4 GB RAM, and storage for logs. For production, pin to a systemd service user.

2. Configure environment variables

Set RESONANCE_MODE=adaptive, RESONANCE_API_KEY, and any Stripe/Intercom keys. Copy the `.env.example` from the repository and customize for your environment.

3. Install dependencies

Install Node.js 18+, pkg, and the Resonance agent repository. Run `npm install` followed by `npm run build` to emit TypeScript artifacts.

4. Launch the agent

Start the agent via `npm run start:agent` or the compiled binary. Verify health endpoints at `/health` and `/metrics` with your API key.

5. Stream phase & latency data

Use the SDK or bench scripts to feed phase samples (`bench/feed_phases.js`) and latency percentiles. Monitor band compliance in the dashboards.

6. Enable auto-updates

Deploy the auto-update manifest and configure the agent with `RESONANCE_UPDATE_MANIFEST_URL`. Ensure file permissions allow staging updates.