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 Human Machine Interface(HMI)
bash scripts/hmi.sh

Access HMI by opening your favorite browser, e.g. Chrome, go to https://localhost:8887, click Dreamview to start.

# 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

Click upper-right Dreamview button

to load Dreamview UI.

Dreamview should show a running vehicle with trajectory now.

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.

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.