Skip to content

wheelos/apollo-lite

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

English | 中文 | 한국어 | 日本語

Documentation Status

A high-performance autonomous driving system

Table of Contents


Introduction

Apollo-Lite provides powerful modules and features for autonomous driving development. Before getting started, please ensure your environment meets the prerequisites and follow the installation instructions below.

For a deeper understanding, refer to the following documents:

  • Design Document: [中文 | [English]]
  • Integration Document: [中文 | [English]]
  • Development Process: [中文 | [English]]
  • Tools Document: [中文 | [English]]
  • Product Manual: [中文 | [English]]
  • Issues / FAQ: [中文 | [English]]
  • WEP Proposal: [中文 | [English]]
  • Company Introduction: [中文 | [English]]

Prerequisites

  • Machine: Minimum 8-core CPU, 8GB RAM
  • GPU: NVIDIA Turing GPU recommended for acceleration
  • Operating System: Ubuntu 20.04 LTS

Quick Start

We recommend using the CPU version for quick experience and verification.

  • The CPU-based image is smaller and has simpler dependencies, making it suitable for beginners and basic planning modules.
  • The GPU version has a larger image size and more complex dependencies, and is more appropriate for deep development scenarios such as deep learning and GPU-accelerated workflows.

1. Install Deployment Tool

pip install whl-deploy

whl-deploy is a tool that simplifies deployment of WheelOS environments using bundle packages or manifest.yaml. For detailed usage, ref docs


2. Setup Host Environment

Run the following to prepare your host machine:

whl-deploy run

3. Start Docker Container

Download and start the Apollo container image (only required once):

bash docker/scripts/dev_start.sh -d testing

To enter the running container environment in subsequent sessions:

bash docker/scripts/dev_into.sh

4. Build Apollo

To build the entire Apollo project:

./apollo.sh build_cpu

To build a specific module:

./apollo.sh build_cpu <module_name>
# Example:
./apollo.sh build_cpu planning

Notes and Troubleshooting

  • Out of Memory (OOM) Issues: If the build process is terminated due to insufficient memory, try limiting the number of CPU threads used during the build:

    ./apollo.sh build_cpu dreamview --cpus=2
  • Slow Download Speeds: If you experience slow downloads, you can manually download the required archive from the following link: Caiyun Cloud Drive (Extraction code: jfwu). After downloading, place the archive in the .cache/distdir directory within your codebase.


Copyright and License

Apollo-Lite is licensed under the Apache License 2.0. Please comply with the license terms when using or contributing to this project.


Connect with Us


Thank you for being part of Apollo-Lite's journey towards autonomous driving innovation!

About

Autonomous Driving Systems

Topics

Resources

License

Code of conduct

Contributing

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published