Skip to content

Project AirSim

AirSim is a simulator for drones, cars and more, built on Unreal Engine Microsoft AirSim was officially archived by Microsoft in 2022. it continue and fork by other i clone ProjectAirSim by IAMAISIM

Project AirSim consists of three main layers:

  • Project AirSim Sim Libs - Base infrastructure for defining a generic robot structure and simulation scene tick loop
  • Project AirSim Plugin - Host package (currently an Unreal Plugin) that builds on the sim libs to connect external components (controller, physics, rendering) at runtime that are specific to each configured robot-type scenario (ex. quadrotor drones)
  • Project AirSim Client Library - End-user library to enable API calls to interact with the robot and simulation over a network connection

Usage

Pre-build environment

I just want to download and run a Project AirSim environment and drive it with some Python code.

The python project airsim client locate at client/python/projectairsim/

Dev

  • Dockerfile to install python dependencies
  • Install prebuild binary
 1
 2
 3
 4
 5
 6
 7
 8
 9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
# syntax=docker/dockerfile:1
FROM nvidia/cuda:12.4.1-runtime-ubuntu22.04

ENV DEBIAN_FRONTEND=noninteractive

# --- OS deps (Python + GL runtime) ---
RUN apt-get update && apt-get install -y --no-install-recommends \
    ca-certificates \
    git \
    python3 \
    python3-pip \
    python3-venv \
    # Fix for: libGL.so.1 not found
    libgl1 \
    # Common runtime libs often needed by OpenCV / GUI-ish deps
    libglib2.0-0 \
    libsm6 \
    libxext6 \
    && rm -rf /var/lib/apt/lists/*

# --- Virtualenv ---
ENV VENV_PATH=/opt/venv
RUN python3 -m venv ${VENV_PATH}
ENV PATH="${VENV_PATH}/bin:${PATH}"

RUN pip install --no-cache-dir -U pip setuptools wheel

# --- Clone ProjectAirSim ---
ARG PROJECTAIRSIM_REF=main
WORKDIR /opt
RUN git clone --depth 1 --branch ${PROJECTAIRSIM_REF} https://github.com/iamaisim/ProjectAirSim.git

# --- Install the Python client ---
WORKDIR /opt/ProjectAirSim/client/python/projectairsim
RUN pip install --no-cache-dir -e .

# Sanity check
RUN python -c "import projectairsim; print('projectairsim import OK')"

WORKDIR /workspace
CMD ["bash"]
docker usage
1
2
3
4
docker run --rm -it --gpus all --net host \
  -e DISPLAY=$DISPLAY \
  -v /tmp/.X11-unix:/tmp/.X11-unix:rw \
airsim:22.04 /bin/bash

1
/opt/ProjectAirSim/client/python/example_user_scripts# python3 hello_drone.py

Reference