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 http://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 http://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.