> 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 Walnut 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="/files/EnVTV6Ecop3nty8T72so" alt=""><figcaption></figcaption></figure>

You will see the Agent panel with options like:

* Start Agent
* Test Connection
* Download Agent

<figure><img src="/files/CaQjzNhOQGGwEzZWtZ5X" 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="/files/Aq2I6PxoVRnqKOnCEIQm" 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="/files/vSolAo6xeOPtE2eiYKd2" alt=""><figcaption></figcaption></figure>

* A browser popup will appear asking to open WalnutAI

<figure><img src="/files/ugIYMUy82SmVRbmw4aNH" alt=""><figcaption></figcaption></figure>

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

<figure><img src="/files/nydTlAxRHfAsglhJGM3j" 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.