Autoware is an open-source software stack for self-driving vehicles, built on the Robot Operating System (ROS). It includes all of the necessary functions to drive an autonomous vehicles from localization and object detection to route planning and control, and was created with the aim of enabling as many individuals and organizations as possible to contribute to open innovations in autonomous driving technology.
To learn more about using or developing Autoware, refer to the Autoware documentation site. You can find the source for the documentation in autowarefoundation/autoware-documentation.
git clone https://github.com/jkk-research/autoware
cd autoware
./setup-dev-env.sh
mkdir src
vcs import src < autoware.repos
rosdep install --from-paths src --ignore-src --rosdistro $ROS_DISTRO -y
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
git pull
vcs import src < autoware.repos
vcs pull src
rosdep install -y --from-paths src --ignore-src --rosdistro $ROS_DISTRO
colcon build --symlink-install --cmake-args -DCMAKE_BUILD_TYPE=Release
- autowarefoundation/autoware
- Meta-repository containing
.reposfiles to construct an Autoware workspace. - It is anticipated that this repository will be frequently forked by users, and so it contains minimal information to avoid unnecessary differences.
- Meta-repository containing
- autowarefoundation/autoware_common
- Library/utility type repository containing commonly referenced ROS packages.
- These packages were moved to a separate repository in order to reduce CI execution time
- autowarefoundation/autoware.core
- Main repository for high-quality, stable ROS packages for Autonomous Driving.
- Based on Autoware.Auto and Autoware.Universe.
- autowarefoundation/autoware.universe
- Repository for experimental, cutting-edge ROS packages for Autonomous Driving.
- Autoware Universe was created to make it easier for researchers and developers to extend the functionality of Autoware Core
- autowarefoundation/autoware_launch
- Launch configuration repository containing node configurations and their parameters.
- autowarefoundation/autoware-github-actions
- Contains reusable GitHub Actions workflows used by multiple repositories for CI.
- Utilizes the DRY concept.
- autowarefoundation/autoware-documentation
- Documentation repository for Autoware users and developers.
- Since Autoware Core/Universe has multiple repositories, a central documentation repository is important to make information accessible from a single place.
If you wish to use Autoware.AI, the previous version of Autoware based on ROS 1, switch to autoware-ai repository. However, be aware that Autoware.AI has reached the end-of-life as of 2022, and we strongly recommend transitioning to Autoware Core/Universe for future use.
- There is no formal process to become a contributor - you can comment on any existing issues or make a pull request on any Autoware repository!
- Make sure to follow the Contribution Guidelines.
- Take a look at Autoware's various working groups to gain an understanding of any work in progress and to see how projects are managed.
- If you have any technical questions, you can start a discussion in the Q&A category to request help and confirm if a potential issue is a bug or not.