# air_agent

**Repository Path**: mirrors_NVIDIA/air_agent

## Basic Information

- **Project Name**: air_agent
- **Description**: A Python agent for receiving instructions from the NVIDIA Air platform
- **Primary Language**: Unknown
- **License**: Apache-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2022-08-04
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# air-agent

The NVIDIA Air Agent is a systemd service that detects if a VM has been cloned. When a clone operation has been detected, it calls out to the Air API to see if there are any post-clone instructions available to execute.

## Pre-requisites

### Ubuntu 18.04/20.04/22.04

Make sure `python3` and either `python3-pip` are installed:

```
sudo apt update && sudo apt install -y python3 python3-pip
```

Install the dependencies via pip:

```
python3 -m pip install .
```

### Ubuntu 24.04

Make sure `python3`, `python3-cryptography`, `python3-git`, `python3-requests` and `util-linux-extra` (required for use of the `hwclock` command by the agent) are installed:

```
sudo apt update && sudo apt install -y python3 python3-cryptography python3-git python3-requests util-linux-extra
```

## Installing

Once the proper dependencies are installed, run the install script:

`sudo ./install.sh`


### For devices where connectivity to Air is desired over a VRF

Pass the desired VRF name to the install script:

`sudo ./install.sh -v <VRF>`

For example, in newer Cumulus Linux versions where eth0 is configured in the mgmt VRF by default:

`sudo ./install.sh -v mgmt`

## Configuration

The Air platform dynamically injects an appropriate agent configuration into the VM via /mnt/air/agent.ini. This path can be overridden with the `-c`/`--config-file` command line argument.

Additionally, individual settings can be overriden using environment variables prefixed with `AIR_AGENT_`. For example, to override the `LOG_LEVEL` setting, set an environment variable named `AIR_AGENT_LOG_LEVEL`.