> 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.


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.walnutai.ai/test-and-quality-management/download-and-set-up-agent.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.