whatisgithub

What is carlaair?

louiszengcn/carlaair — explained in plain English

Analysis updated 2026-05-18

941C++Audience · researcherComplexity · 5/5LicenseSetup · hard

In one sentence

A simulator that merges CARLA's urban driving and AirSim's drone flight into one process, letting researchers test ground and air vehicles together.

Mindmap

mindmap
  root((repo))
    What it does
      Merges CARLA and AirSim
      Single process, no bridge
      Aligned coordinates
    Tech stack
      C++
      Unreal Engine
      ROS2
    Use cases
      Air-ground robotics research
      Multi-sensor data collection
      Existing script compatibility
    Audience
      Robotics researchers
    Setup
      Prebuilt executables
      Build from source

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

What do people build with it?

USE CASE 1

Simulate a drone and ground vehicles interacting in the same urban environment.

USE CASE 2

Test air-ground embodied AI research with synchronized multi-sensor data.

USE CASE 3

Run existing CARLA or AirSim Python scripts and ROS 2 nodes with no code changes.

USE CASE 4

Collect frame-aligned camera, LiDAR, radar, and GPS data across vehicles and drones.

What is it built with?

C++PythonCARLAAirSimROS2Unreal Engine

How does it compare?

louiszengcn/carlaairredis/memtier_benchmarkkeyboardio/kaleidoscope
Stars9411,041812
LanguageC++C++C++
Last pushed2026-07-02
MaintenanceActive
Setup difficultyhardmoderatemoderate
Complexity5/53/53/5
Audienceresearcherops devopsdeveloper

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · hard Time to first run · 1h+

Prebuilt binaries avoid compiling, but it needs a capable GPU and Unreal Engine dependencies.

Custom non-commercial license: free for research and personal use but not for commercial purposes.

So what is it?

CARLA-Air is a simulation platform that combines two existing simulation systems, CARLA for realistic urban driving and AirSim for physics accurate drone flight, into a single program. The goal is to let researchers test scenarios where ground vehicles and flying drones need to interact in the same simulated city, something that used to require running two separate simulators and bridging them together, which added delay and complexity. Instead of connecting two programs over a network, CARLA-Air modifies CARLA's game mode to also host AirSim's drone physics inside the same process, so there is no bridge and no added latency between the two systems. The authors say only about thirty five lines of code were changed in the upstream CARLA source to make this work, and the coordinate systems of both simulators are aligned so a position reported by one exactly matches the same position in the other. The platform supports up to eighteen different sensor types, including regular color cameras, depth cameras, semantic and instance segmentation, LiDAR, radar, and GPS, all synchronized across both ground vehicles and drones. Existing CARLA and AirSim Python scripts, as well as ROS 2 nodes, are reported to run without any code changes, and the project includes prebuilt ROS 2 examples. In testing, a typical workload combining vehicles, a drone, and eight sensors ran at close to twenty frames per second, and the authors ran the simulator continuously for three hours with hundreds of spawn and despawn cycles without any crashes. The project provides prebuilt executables for both Ubuntu and Windows so most users do not need to compile anything themselves, though building from source is also documented. The license is a custom non-commercial license, so review it carefully before using this for anything beyond research or personal projects.

Copy-paste prompts

Prompt 1
Help me download and run the prebuilt CARLA-Air executable on Ubuntu.
Prompt 2
Show me a Python script that spawns a drone and a car in the same CARLA-Air world.
Prompt 3
Explain how CARLA-Air keeps CARLA and AirSim coordinate systems aligned.
Prompt 4
Walk me through setting up the ROS 2 examples included in CARLA-Air.

Frequently asked questions

What is carlaair?

A simulator that merges CARLA's urban driving and AirSim's drone flight into one process, letting researchers test ground and air vehicles together.

What language is carlaair written in?

Mainly C++. The stack also includes C++, Python, CARLA.

What license does carlaair use?

Custom non-commercial license: free for research and personal use but not for commercial purposes.

How hard is carlaair to set up?

Setup difficulty is rated hard, with roughly 1h+ to a first successful run.

Who is carlaair for?

Mainly researcher.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.