explaingit

carla-simulator/carla

13,946C++Audience · researcherComplexity · 5/5LicenseSetup · hard

TLDR

CARLA is an open-source simulator for autonomous vehicle research that lets you test self-driving software in a virtual city with configurable sensors, traffic, and weather instead of real roads.

Mindmap

mindmap
  root((repo))
    What it does
      Autonomous driving sim
      Safe test environment
      Repeatable scenarios
    Features
      Configurable sensors
      Weather control
      Traffic simulation
      Python API
    Tools
      Leaderboard
      Scenario runner
      ROS bridge
    Requirements
      NVIDIA RTX GPU
      32GB RAM
      Ubuntu 20.04
Click or tap to explore — scroll the page freely

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

Things people build with this

USE CASE 1

Train and evaluate a self-driving algorithm in a simulated city without risk to real vehicles or people.

USE CASE 2

Create repeatable traffic scenarios with specific weather and sensor configurations to benchmark autonomous driving software.

USE CASE 3

Connect a ROS-based robotics pipeline to a virtual vehicle with a configurable camera and sensor rig.

USE CASE 4

Run the CARLA public leaderboard evaluation to compare autonomous driving approaches using a standard benchmark.

Tech stack

C++PythonUnreal Engine

Getting it running

Difficulty · hard Time to first run · 1day+

Requires an NVIDIA RTX GPU, 32 GB RAM, and Ubuntu 20.04, building from source also requires a custom Unreal Engine fork.

Code is MIT licensed, use freely including commercially, assets are Creative Commons and some bundled dependencies carry their own separate terms.

In plain English

CARLA is an open-source simulator built for research into self-driving cars. Instead of testing driving software on real roads, which is slow, expensive, and risky, researchers can run it inside CARLA's virtual world of streets, buildings, and traffic. The project was created from the ground up to help people develop, train, and check autonomous driving systems in a safe, repeatable setting. Along with the code, CARLA provides ready-made digital assets that you can use freely. These include city layouts, buildings, and vehicles that were made specifically for the simulator. The platform lets you decide what sensors a virtual car carries, for example cameras or other detectors, and lets you set the environmental conditions such as weather. That flexibility means a team can recreate the exact situations they want to study and repeat them as many times as needed. CARLA is a demanding program to run. The recommended setup listed in the README includes a recent high-end Intel or AMD processor, at least 32 GB of memory, a powerful NVIDIA RTX graphics card, and Ubuntu 20.04. Ready-to-use builds are available for both Linux and Windows, and there are separate downloads for additional maps. People who want to build it themselves can clone the repository along with a special version of the Unreal Engine that CARLA depends on, then follow the build guides. The project sits at the center of a wider set of related tools. These include a public leaderboard for validating driving software, a scenario runner for staging traffic situations, a bridge to the ROS robotics framework, and benchmarks for driving tasks. Detailed documentation, a Python programming interface, tutorials, and a frequently asked questions page are hosted online. Licensing is split by component. CARLA's own code is released under the MIT license and its assets under a Creative Commons license, while some integrated dependencies and the Unreal Engine carry their own separate license terms that users should review. The README also asks that anyone using CARLA in published work cite the project's original 2017 research paper.

Copy-paste prompts

Prompt 1
I have CARLA running on Ubuntu with an NVIDIA RTX GPU. Help me write a Python script using the CARLA Python API to spawn a vehicle, attach a camera sensor, and save captured frames to disk.
Prompt 2
Walk me through using CARLA's scenario runner to set up a specific intersection situation with opposing traffic that I want to test repeatedly.
Prompt 3
How do I connect CARLA to a ROS bridge so my ROS-based self-driving stack can receive lidar and camera sensor data from the simulator?
Prompt 4
I want to run the CARLA leaderboard benchmark for my driving agent. Explain the setup steps and what metrics the leaderboard reports.
Open on GitHub → Explain another repo

← carla-simulator on gitmyhub — every repo by this author, as a profile.

Verify against the repo before relying on details.