Assetto Corsa Interface, a new racing benchmark

Assetto Corsa is a racing simulation game that allows players to drive a variety of cars on different tracks. AC Interface lets robots drive cars in Assetto Corsa.

Usage

Defining an Agent

To define your own and allow it to control a car in the game create a class that inherits from aci.interface.AssettoCorsaInterface and define a function named behaviour(self, observation: Dict) -> np.array. To test your agent create a main method that instances your new Agent class and calls agent.run(). As an example here is an agent that does nothing:

from aci.interface import AssettoCorsaInterface

class MyCoolAgent(AssettoCorsaInterface):
    def behaviour(self, observation: Dict) -> np.array:
        return np.array([0.0, 0.0, 0.0])

if __name__=="__main__":
    agent = MyCoolAgent()
    agent.run()

More examples of how to do this can be found in the /examples folder.

Record A Game Session

An example of using our interface to record a game session is:

from aci.recorder import AssettoCorsaRecorder

if __name__ == "__main__":
    save_path = "./test/monza_audi_r8_lms_1"
    recorder = AssettoCorsaRecorder()
    recorder.run(save_path)

To finish recording use a keyboard interrupt (crt+c) on the terminal running the script.

Installation

As Assetto Corsa is a windows native application it needs be run using a compatibility tool. Currently we support using CrossOver or Steam's Proton.

CrossOver

Proton

Citation

If you use ACI in your research please cite us in your work:

@misc{bockman2024aarkopentoolkitautonomous,
      title={AARK: An Open Toolkit for Autonomous Racing Research}, 
      author={James Bockman and Matthew Howe and Adrian Orenstein and Feras Dayoub},
      year={2024},
      eprint={2410.00358},
      archivePrefix={arXiv},
      primaryClass={cs.RO},
      url={https://arxiv.org/abs/2410.00358}, 
}