Skip to content

About

A high-performance autonomous driving system

Topics

Resources

Stars

177 stars

Watchers

4 watching

Forks

Latest commit

 

History

227 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

WheelOS

Apollo-Lite low-speed autonomous-driving integration

English | 中文

Lint and format License

What this repository provides

Apollo-Lite is a product-integration root for a low-speed autonomous-driving system. It combines independently versioned hardware, perception, localization, planning, control, runtime and tool repositories through Bzlmod.

The repository owns:

  • low-speed product configuration and launch topology;
  • hardware, module and runtime-product selection;
  • the managed Ubuntu development environment;
  • runtime assembly, packaging, installation and cross-module tests;
  • contributor and agent workflows.

It does not own the implementation of every algorithm module. Those modules remain in their source repositories listed in wheelos.repos.

Choose your path

Goal Start here
Prepare the host and enter the development container Host setup
Preview or build a product inventory Product builds
Inspect the low-speed product definition products/low_speed
Build a complete runtime product Runtime products
Select hardware or sensor backends Hardware builds
Select algorithm modules Selected modules
Assemble one shared Cyber system System assembly
Use operational and debugging tools Tool documentation
Contribute code or investigate failures Agent Guide
Browse all documentation Documentation map

Quick start

Prerequisites:

  • Ubuntu 22.04 host with Docker, or a compatible environment prepared by setup_host.sh;
  • at least 8 CPU cores and 8 GB RAM recommended;
  • an NVIDIA Turing or newer GPU for the GPU workflow;
  • a local checkout of the repositories declared in wheelos.repos when using local source overrides.

Prepare the host, start the container and enter it:

sudo bash docker/setup_host/setup_host.sh
whl start dev
whl enter dev

Preview a low-speed build inventory before compiling:

bash apollo.sh profiles
bash apollo.sh build --product=devkit-x86 --show

Build and run the explicit low-speed runtime product:

bash apollo.sh build \
  --product=//products/low_speed:devkit_x86 \
  --config=product_devkit-x86 \
  --show

bash apollo.sh run \
  --product=//products/low_speed:devkit_x86 \
  --config=product_devkit-x86 \
  -- --launch launch/low_speed/devkit_x86.launch

devkit-x86 is a build inventory. //products/low_speed:devkit_x86 is the runtime-product label used for build, run, package and install. They serve different purposes and should not be treated as interchangeable deployment qualification.

For local delivery validation, add --source=dev:

bash apollo.sh package \
  --product=//products/low_speed:devkit_x86 \
  --source=dev \
  --config=product_devkit-x86

bash apollo.sh install \
  --product=//products/low_speed:devkit_x86 \
  --source=dev \
  --config=product_devkit-x86 \
  --destdir=/absolute/install/path

Do not start vehicle or sensor programs until the target hardware, calibration, domain, topic and safety configuration have been reviewed.

Repository map

Path Responsibility
products/low_speed/ Low-speed product defaults, vehicle template and launch topology
tools/products/ Customer-facing build inventories and runtime_product assembly
tools/hardware/ Hardware profile selection, runtime assembly and packaging
tools/modules/ Algorithm-module selection across external repositories
tools/system/ One shared Core/tool/configuration system with explicit modules
tools/transform/ Transform runtime assembly and service example
docker/ Host setup, container definitions and container lifecycle
scripts/ Build, runtime, CI and agent tooling
modules/tools/ Transitional operational and debugging tools
.agents/ Task procedures and workflow specifications
docs/ Repository documentation map and setup guides

Scope and safety

All devkit-* products are example integration inventories unless explicitly qualified for a deployment. They are not vehicle safety certification.

  • Installation never starts components.
  • Hardware and sensor startup requires reviewed DAGs, configuration and calibration.
  • Release delivery must use immutable source versions and the formal Bzlmod registry path.
  • Road, HIL, and control-actuation runs require explicit approval and the applicable safety procedure.

Documentation and contribution

License

Apollo-Lite is licensed under the Apache License 2.0.

For collaboration and business inquiries, contact daohu527@gmail.com.

About

A high-performance autonomous driving system

Topics

Resources

Stars

177 stars

Watchers

4 watching

Forks

Releases

Packages

Contributors

Languages