> For the complete documentation index, see [llms.txt](https://roar.gitbook.io/roar-competition-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://roar.gitbook.io/roar-competition-documentation/installation.md).

# Installation

{% hint style="info" %}
Starting from Fall 2023, ROAR Competition will be running on Monza Map with the ROAR\_PY repository as the reference code base.

You can download Monza Map executables [here](https://roar.berkeley.edu/monza-map/) (Windows AMD64)
{% endhint %}

<figure><img src="/files/i0B6kh5kH54qmmirXPTI" alt="" width="563"><figcaption><p>A screenshot of Monza Map V1.1</p></figcaption></figure>

## Installing ROAR\_PY

{% hint style="info" %}
If you want a clean installation of the competition suite, maybe you will want to name your conda environments differently. We suggest using a separate roar\_competition conda environment with python 3.8 to run your competition codes.

Specifically, run `conda create -n roar_competition python=3.8` first then run `conda activate roar_competition`, then run commands specified in the interface/carla implementation installation commands in the sections below
{% endhint %}

Now follow instructions described in&#x20;

{% content-ref url="/spaces/RNhgbMBKC4oJxk48MI9Y/pages/YjCq0Livr7pE5TS5kcr6" %}
[Interface Installation](https://roar.gitbook.io/roar_py-documentation/interface-installation)
{% endcontent-ref %}

{% content-ref url="/spaces/RNhgbMBKC4oJxk48MI9Y/pages/xIC6faA1o6skFLJynbzt" %}
[Carla Installation](https://roar.gitbook.io/roar_py-documentation/implementation-installation/carla-installation)
{% endcontent-ref %}

{% hint style="info" %}
You need to install both the ROAR\_PY interface and the Carla implementation layers.
{% endhint %}

As an additional version check, make sure your Carla PythonAPI's version is 0.9.12 by running

```sh
pip3 install carla==0.9.12
```

## Cloning down competition skeletons

Now open up <https://github.com/augcog/ROAR_Competition> in your browser and click on the "fork" button.&#x20;

<figure><img src="/files/0ZVIdCilZrmZ9Lzv73Gy" alt="" width="563"><figcaption><p>Click on the "fork" button in the top-right corner of the browser window</p></figcaption></figure>

After forking the ROAR\_Competition code you should have a child repository of the given skeleton code. It should have a URL that looks like this:

```
https://github.com/YOUR_USERNAME/ROAR_Competition
```

Now clone down this repository by using `git clone URL_TO_YOUR_FORKED_REPO` and start modifying the `submission.py` file.


---

# 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://roar.gitbook.io/roar-competition-documentation/installation.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.
