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.
| 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 |
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.reposwhen 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 devPreview a low-speed build inventory before compiling:
bash apollo.sh profiles
bash apollo.sh build --product=devkit-x86 --showBuild 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.launchdevkit-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/pathDo not start vehicle or sensor programs until the target hardware, calibration, domain, topic and safety configuration have been reviewed.
| 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 |
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 map
- Host setup and container lifecycle
- Build and runtime products
- Hardware profiles
- Agent Guide
- Skills
- Workflows
- Agent tooling
- Issues and support
Apollo-Lite is licensed under the Apache License 2.0.
For collaboration and business inquiries, contact daohu527@gmail.com.
