gitwtfhub

wtf is autoware?

autowarefoundation/autoware — explained in plain English

Analysis updated 2026-06-24

★ 11,582DockerfileAudience · researcherComplexity · 5/5Setup · hard

TL;DR

An open-source software stack that gives self-driving vehicles the ability to locate themselves on a map, detect obstacles, plan routes, and control steering and braking, built on the ROS 2 robotics framework.

Mindmap

mindmap
  root((autoware))
    What it does
      Self driving stack
      Localization
      Object detection
      Route planning
    Tech stack
      ROS 2
      Docker
      C plus plus
    Use cases
      Simulation testing
      Research vehicles
      Algorithm development
    Audience
      Researchers
      Robotics engineers
      Automotive teams

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

Why would anyone build with this?

REASON 1

Run Autoware in a simulator to test self-driving algorithms without needing a physical vehicle.

REASON 2

Integrate Autoware's localization and object detection modules into a research or prototype vehicle.

REASON 3

Contribute new perception or planning algorithms to the Autoware universe of experimental packages.

REASON 4

Evaluate a production-grade self-driving software stack as a baseline for academic research.

What's in the stack?

ROS 2DockerC++PythonDockerfile

How it stacks up

autowarefoundation/autowarelaradock/laradockjessfraz/dockerfiles
Stars11,58212,66213,934
LanguageDockerfileDockerfileDockerfile
Setup difficultyhardmoderatemoderate
Complexity5/53/52/5
Audienceresearcherdeveloperops devops

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

How do you spin it up?

Difficulty · hard Time to first run · 1day+

Requires significant hardware, ROS 2 expertise, and either a simulation environment or a real vehicle to deploy on.

Wtf does this do

Autoware is an open-source software stack for self-driving vehicles. It provides all the software components a vehicle needs to drive itself: figuring out where it is on a map (localization), detecting other cars, pedestrians, and obstacles (object detection), planning a route, and sending the right commands to the steering and brakes (control). The project is built on ROS 2, a widely used framework for robotics software that handles communication between the different software components. This particular repository is the top-level entry point for Autoware. It is mainly a configuration file that tells a build tool which other Autoware repositories to download and assemble into a working workspace. The actual code lives across several companion repositories: autoware_core contains stable, production-quality packages, autoware_universe contains newer experimental packages that researchers and developers use to extend the system, and autoware_launch contains the configuration files needed to start everything up. The project is governed by the Autoware Foundation, a non-profit that coordinates contributions from companies and research groups around the world. There is no formal barrier to contributing: anyone can comment on issues or submit pull requests to any of the Autoware repositories. The foundation maintains working groups for different areas of the system, and a Discord server for real-time discussion. If you are evaluating Autoware: it targets real vehicles and simulation environments, not hobby robots. It requires significant hardware and expertise to deploy in a vehicle. The documentation site at autowarefoundation.github.io is the starting point for learning how to set up a development environment and run Autoware in a simulator. The older version built on ROS 1 (Autoware.AI) reached end-of-life in 2022 and is no longer recommended.

Yoink these prompts

Prompt 1
I want to run Autoware in a simulator. Walk me through setting up a development environment with Docker and running the default demo.
Prompt 2
Explain how Autoware handles localization, how does a self-driving car using Autoware know where it is on a map?
Prompt 3
I'm a researcher adding a new object detection model to Autoware. Which repository should I modify and how does autoware_universe work?
Prompt 4
What hardware and compute resources do I realistically need to run Autoware on a real vehicle rather than just in simulation?

Frequently asked questions

wtf is autoware?

An open-source software stack that gives self-driving vehicles the ability to locate themselves on a map, detect obstacles, plan routes, and control steering and braking, built on the ROS 2 robotics framework.

What language is autoware written in?

Mainly Dockerfile. The stack also includes ROS 2, Docker, C++.

How hard is autoware to set up?

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

Who is autoware for?

Mainly researcher.

View the repo → Decode another repo

This repo across BitVibe Labs

Don't trust strangers blindly. Verify against the repo.

Other repos in this lane