> ## Documentation Index
> Fetch the complete documentation index at: https://docs.glasswarp.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Install the host agent

> Put the Glasswarp host on a Windows machine so agents get eyes and hands.

Glasswarp drives a **real Windows machine you own** — your GPU, your apps, your
files. The host agent is the black box that runs there: it captures the screen,
encodes it, and injects native input, with a visible session indicator and a
kill switch.

<Info>
  This is a physical, one-time, owner-consent step. A coding agent can wire up
  your project, but a human must install the host and enable API access.
</Info>

## Requirements

* Windows 10/11 (64-bit).
* A GPU is recommended for NVENC hardware encode (falls back gracefully).
* Owner access to the machine.

## Install

<Steps>
  <Step title="Download the host agent">
    Grab the installer from
    [glasswarp.com/downloads](https://www.glasswarp.com/downloads) on the
    Windows machine.
  </Step>

  <Step title="Run the installer">
    Launch it and follow the prompts. The host installs as a background agent.
  </Step>

  <Step title="Sign in and pair">
    Sign in with your Glasswarp account to pair this machine to your account.
    See [Pair a rig](/get-started/pair-rig).
  </Step>

  <Step title="Enable API access">
    In the [Console → Rigs](https://www.glasswarp.com/console), confirm the rig
    is online and turn on **API access**. It is off by default.
  </Step>
</Steps>

## Verify

From your dev machine, list rigs and confirm yours is eligible:

```python theme={null}
import os
from glasswarp import GlasswarpClient

gw = GlasswarpClient(api_key=os.environ["GLASSWARP_API_KEY"])
for rig in gw.list_rigs():
    print(rig.id, rig.online, rig.api_access_enabled)
```

You should see your machine with `online=True` and `api_access_enabled=True`.

<Warning>
  If API access is off, sessions will be refused. This is the per-rig consent
  guardrail — see [Safety and consent](/concepts/safety-and-consent).
</Warning>

Next: [pair the rig](/get-started/pair-rig) and [start your first
session](/get-started/first-session).