We choose to go to the moon in this decade and do the other things,
not because they are easy, but because they are hard.
-- John F. Kennedy, 1962

Welcome to the Apollo GitHub.

Apollo is an open autonomous driving platform. It is a high performance flexible architecture which supports fully autonomous driving capabilities. For business contact, please visit https://apollo.auto

We strongly recommend building Apollo in our pre-specified Docker environment. See the following instructions on how to set up the docker environment and build from source.

bash docker/scripts/install_docker.sh
# logout and login the computer to make sure to run docker command without sudo
docker ps  # to verify docker works without sudo
# in case you forgot to logout and login back, do so, remove ~/.docker/config.json
# and check again with `docker ps`
bash docker/scripts/dev_start.sh
bash docker/scripts/dev_into.sh

bash apollo.sh build

Follow the steps below to launch Apollo:

# start module monitor
bash scripts/bootstrap.sh

Access Dreamview by opening your favorite browser, e.g. Chrome, go to https://localhost:8888

# in a different terminal, in the apollo directory
bash docker/scripts/dev_into.sh # jump into the docker container
bash ./docs/demo_guide/rosbag_helper.sh download # download rosbag
rosbag play -l ./docs/demo_guide/demo_1.5.np.bag

Dreamview should show a running vehicle now. (The following image might be different due to changes in frontend.)

Advanced users who wish to build outside this Docker container can refer to the corresponding Docker specification file (./docker/dev.dockerfile).

Apollo documents can be found under the docs repository.

• quickstart: the quickstart tutorial.
• demo_guide: the guide for demonstration.
• 
• how to contribute code: the guide for contributing code to Apollo.
• howto: tutorials on how to build, run and modify codes.
• specs: Specification documents of Apollo 1.5.
• Doxygen APIs: Apollo Doxygen pages

You are welcome to submit questions and bug reports as Github Issues.

Apollo is provided under the Apache-2.0 license.

Please refer the Disclaimer of Apollo in Apollo official website.