whatisgithub

What is autoware?

autowarefoundation/autoware — explained in plain English

Analysis updated 2026-06-24

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

In one sentence

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
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

What do people build with it?

USE CASE 1

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

USE CASE 2

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

USE CASE 3

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

USE CASE 4

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

What is it built with?

ROS 2DockerC++PythonDockerfile

How does it compare?

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 get it running?

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.

So what is it?

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.

Copy-paste 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

What 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.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.