Skip to main content

Install

Follow these steps to install AssettoCorsaRL, set up Content Manager with Custom Shaders Patch, install the Monaco track and the VRC Formula Alpha car, then run a Hotlap.

Prerequisites​

  • Python 3.10 or later
  • Assetto Corsa (base game)

Installation​

1. Install AssettoCorsaRL​

Install the package from PyPI:

pip install assetto-corsa-rl
tip

Using a Virtual Environment (Optional)

For better isolation, create a Python virtual environment:

python -m venv acrl-env
acrl-env\Scripts\activate
source acrl-env/bin/activate

pip install assetto-corsa-rl

Alternatively, you can use Anaconda:

conda create -n acrl python=3.10
conda activate acrl
pip install assetto-corsa-rl

Or, install from the GitHub repository:

git clone https://github.com/AssettoCorsaRL/AssettoCorsaRL
cd assetto-corsa-rl
pip install -e ./assetto-corsa-rl

The acrl CLI command is now available in your terminal. Verify the installation:

acrl --help

2. Download the Pretrained Model​

Download the pretrained model from Hugging Face into a directory:

pip install huggingface_hub
hf download ved-patel226/AssettoCorsaRL --local-dir .
Note Down Model Paths

After downloading, note the absolute paths for:

  • bc_sac_pretrained.pt
  • loss=0.1050.ckpt

You'll need these paths to test the model later.

3. Install Content Manager and the Custom Shaders Patch (CSP)​

  • Follow this video to install Content Manager and Custom Shaders Patch (step at ~1:08 shows the install process): https://youtu.be/qVjE2FG5MRA?si=cUVu5k7oIzNDJ-Wx&t=68
  • After installing Content Manager, install CSP through Content Manager's "Mods" or "Settings → Custom Shaders Patch" flow as shown in the video.

4. Install the AssettoCorsaRL App​

5. Install the Monaco track (Monaco F1 2022):​

6. Install the Formula Alpha 2022 car:​

7. Settings​

8. Run a Hotlap​

Next Steps​