> For the complete documentation index, see [llms.txt](https://docs.walnutai.ai/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.walnutai.ai/test-and-quality-management/download-and-set-up-agent.md).

# Download and Set Up Agent

Setting up the Agent in WalnutAI is a simple and structured process that allows you to enable smart recording, test execution, and AI-powered actions from your system.

### Why is Agent necessary?

* Enable **Smart Recording**
* Perform **Test Execution**
* Run **AI-powered actions**

The setup is completed in four main steps:

#### Access Agent & Download

Click on the **Agent icon** located at the top right corner next to your profile.

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FlEqZ37r4OOx0bG7E2c6g%2Fagentoff.png?alt=media&amp;token=f6de50d3-df86-4d6c-b968-def83e97d703" alt=""><figcaption></figcaption></figure>

You will see the Agent panel with options like:

* Start Agent
* Test Connection
* Download Agent

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FPKpzHGyCeAq7te3BxMlR%2Fimage.png?alt=media&amp;token=97ee7d48-bf9f-471d-bf65-ff979cba7f16" alt=""><figcaption></figcaption></figure>

Click on “**Download Agent**,” and the system will automatically detect your device and display the appropriate option—Windows or Mac

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FmPwjMUl3j8C3GltjekKD%2Fimage.png?alt=media&amp;token=c8088e09-cd1c-41be-a203-ba4c09e62966" alt=""><figcaption></figcaption></figure>

The agent file (e.g., `.exe` for Windows and `.dmg` for Mac) will be downloaded to your system.

#### Install & Launch Agent

* Open the downloaded file and complete the installation.
* Once installed, launch the Agent on your system.

#### Make the Agent available

After launching the Agent:

* Click on **Start Agent** from the Agent panel

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2Fu7kTAvgz74m8GJefJWzb%2Fimage.png?alt=media&amp;token=f67bcdef-d17b-4afd-af16-b7789a9da576" alt=""><figcaption></figcaption></figure>

* A browser popup will appear asking to open WalnutAI

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FFmQt0UI8DIIbq7S8n0U1%2Fimage.png?alt=media&amp;token=6605ca1f-0940-429d-b27f-a1e7a149ea7e" alt=""><figcaption></figcaption></figure>

* Click on **Open WalnutAI Agent**
* The agent status will change from **Offline** to **Online**
* A **green indicator** will appear, confirming the agent is connected

<figure><img src="https://295337183-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F9aroNmDWVJAmMjkdy0hx%2Fuploads%2FU6WZOGPgJqhCtPmpKVlB%2Fimage.png?alt=media&amp;token=613d8f41-3b3d-4f88-81ac-95d76671abc6" alt=""><figcaption></figcaption></figure>

#### Update Agent

Go to the installed Agent on your system.\
Right-click on the Agent icon and click on **Update Agent**.

* The update will install automatically
* If a new version is available, an **Update Available** notification will be shown

This process ensures your agent is installed, updated, and running successfully.