# commaai/openpilot architecture

> Architecture diagram of the GitHub repository commaai/openpilot, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-09-21). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/commaai/openpilot
- Repository: https://github.com/commaai/openpilot

## Overview

openpilot is a robotics operating system providing driver assistance for supported cars. The principal workflow is: cameras and vehicle sensors produce observations; model, localization, planning, and control processes compute driving commands; panda communicates those commands to the car; the UI presents state and alerts. The manager initializes parameters, registers the device, and supervises runtime processes. Logging, upload, networking, remote routes, replay, and CAN-analysis tools are additional product capabilities. Several process internals were not sampled, so only documented or directly evidenced wiring is shown.

Main entry points: [`openpilot/cereal/messaging/messaging.h`](https://github.com/commaai/openpilot/blob/master/openpilot/cereal/messaging/messaging.h) (Messaging Bus), [`openpilot/system/manager/manager.py`](https://github.com/commaai/openpilot/blob/master/openpilot/system/manager/manager.py) (Process Manager), [`openpilot/selfdrive/pandad/pandad.py`](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/pandad/pandad.py) (Panda Daemon), [`openpilot/system/camerad/main.cc`](https://github.com/commaai/openpilot/blob/master/openpilot/system/camerad/main.cc) (Camera Daemon)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sensing["Vehicle Sensing"]
  node_camerad["Camera Daemon<br/>[main.cc]"]
  node_sensord["Sensor Daemon<br/>[sensord.py]"]
  node_gpsd["GPS Daemon<br/>[ubloxd.py]"]
  node_pandad["Panda Daemon<br/>[pandad.py]"]
end

subgraph group_driving["Driving Intelligence"]
  node_modeld["Driving Model<br/>[modeld.py]"]
  node_locationd["Localization<br/>[locationd.py]"]
  node_plannerd["Motion Planner<br/>[plannerd.py]"]
  node_controlsd["Vehicle Controller<br/>[controlsd.py]"]
end

subgraph group_runtime["Device Runtime"]
  node_message_bus["Messaging Bus<br/>[messaging.h]"]
  node_manager["Process Manager<br/>[manager.py]"]
  node_params[("Persistent Params<br/>[params.py]")]
  node_loggerd["Drive Logger<br/>[loggerd.cc]"]
  node_uploader["Data Uploader<br/>[uploader.py]"]
end

subgraph group_experience["User Experience"]
  node_ui["Onroad UI<br/>[main.py]"]
  node_alerts["Alert Manager<br/>[alertmanager.py]"]
  node_wifi["WiFi Manager<br/>[wifi_manager.py]"]
end

subgraph group_tools["Analysis Tools"]
  node_cabana["CAN Analyzer<br/>[main.cc]"]
  node_routes["Remote Routes<br/>[routesdialog.cc]"]
  node_replay["Route Replay<br/>[main.cc]"]
  node_jotpluggler["Log Explorer<br/>[app.cc]"]
end

node_driver(("Driver"))
node_vehicle["Supported Car"]
node_comma_cloud["Comma Cloud"]

node_manager -->|"initializes"| node_params
node_manager -->|"registers device"| node_comma_cloud
node_manager -->|"starts process"| node_camerad
node_manager -->|"starts process"| node_sensord
node_manager -->|"starts process"| node_pandad
node_camerad -->|"publishes frames"| node_message_bus
node_sensord -->|"publishes sensors"| node_message_bus
node_gpsd -->|"publishes GPS"| node_message_bus
node_pandad -->|"publishes CAN"| node_message_bus
node_message_bus -->|"delivers frames"| node_modeld
node_message_bus -->|"delivers sensors"| node_locationd
node_modeld -->|"publishes predictions"| node_message_bus
node_locationd -->|"publishes pose"| node_message_bus
node_plannerd -->|"publishes plan"| node_message_bus
node_controlsd -->|"sends commands"| node_pandad
node_driver -->|"operates interface"| node_ui
node_ui -->|"publishes bookmarks"| node_message_bus
node_alerts -->|"stores alerts"| node_params
node_loggerd -->|"records streams"| node_message_bus
node_uploader -.->|"uploads driving data"| node_comma_cloud
node_wifi -.->|"connects network"| node_comma_cloud
node_routes -.->|"fetches routes"| node_comma_cloud
node_cabana -->|"loads route data"| node_replay
node_jotpluggler -.->|"streams routes"| node_comma_cloud
node_vehicle -->|"exchanges CAN"| node_pandad

click node_camerad "https://github.com/commaai/openpilot/blob/master/openpilot/system/camerad/main.cc"
click node_sensord "https://github.com/commaai/openpilot/blob/master/openpilot/system/sensord/sensord.py"
click node_gpsd "https://github.com/commaai/openpilot/blob/master/openpilot/system/ubloxd/ubloxd.py"
click node_pandad "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/pandad/pandad.py"
click node_message_bus "https://github.com/commaai/openpilot/blob/master/openpilot/cereal/messaging/messaging.h"
click node_modeld "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/modeld/modeld.py"
click node_locationd "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/locationd/locationd.py"
click node_plannerd "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/controls/plannerd.py"
click node_controlsd "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/controls/controlsd.py"
click node_manager "https://github.com/commaai/openpilot/blob/master/openpilot/system/manager/manager.py"
click node_params "https://github.com/commaai/openpilot/blob/master/openpilot/common/params.py"
click node_loggerd "https://github.com/commaai/openpilot/blob/master/openpilot/system/loggerd/loggerd.cc"
click node_uploader "https://github.com/commaai/openpilot/blob/master/openpilot/system/loggerd/uploader.py"
click node_ui "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/ui/layouts/main.py"
click node_alerts "https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/selfdrived/alertmanager.py"
click node_wifi "https://github.com/commaai/openpilot/blob/master/openpilot/system/ui/lib/wifi_manager.py"
click node_cabana "https://github.com/commaai/openpilot/blob/master/openpilot/tools/cabana/ui/main.cc"
click node_routes "https://github.com/commaai/openpilot/blob/master/openpilot/tools/cabana/ui/dialogs/routesdialog.cc"
click node_replay "https://github.com/commaai/openpilot/blob/master/openpilot/tools/replay/main.cc"
click node_jotpluggler "https://github.com/commaai/openpilot/blob/master/openpilot/tools/jotpluggler/app.cc"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_camerad,node_sensord,node_gpsd,node_pandad toneBlue
class node_modeld,node_locationd,node_plannerd,node_controlsd toneAmber
class node_message_bus,node_manager,node_params,node_loggerd,node_uploader toneMint
class node_ui,node_alerts,node_wifi toneRose
class node_cabana,node_routes,node_replay,node_jotpluggler,node_driver,node_vehicle,node_comma_cloud toneIndigo
```

## Components

### Vehicle Sensing

- [Camera Daemon](https://github.com/commaai/openpilot/blob/master/openpilot/system/camerad/main.cc): `openpilot/system/camerad/main.cc`
- [Sensor Daemon](https://github.com/commaai/openpilot/blob/master/openpilot/system/sensord/sensord.py): `openpilot/system/sensord/sensord.py`
- [GPS Daemon](https://github.com/commaai/openpilot/blob/master/openpilot/system/ubloxd/ubloxd.py): `openpilot/system/ubloxd/ubloxd.py`
- [Panda Daemon](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/pandad/pandad.py): `openpilot/selfdrive/pandad/pandad.py`

### Driving Intelligence

- [Driving Model](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/modeld/modeld.py): `openpilot/selfdrive/modeld/modeld.py`
- [Localization](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/locationd/locationd.py): `openpilot/selfdrive/locationd/locationd.py`
- [Motion Planner](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/controls/plannerd.py): `openpilot/selfdrive/controls/plannerd.py`
- [Vehicle Controller](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/controls/controlsd.py): `openpilot/selfdrive/controls/controlsd.py`

### Device Runtime

- [Messaging Bus](https://github.com/commaai/openpilot/blob/master/openpilot/cereal/messaging/messaging.h): `openpilot/cereal/messaging/messaging.h`
- [Process Manager](https://github.com/commaai/openpilot/blob/master/openpilot/system/manager/manager.py): `openpilot/system/manager/manager.py`
- [Persistent Params](https://github.com/commaai/openpilot/blob/master/openpilot/common/params.py): `openpilot/common/params.py`
- [Drive Logger](https://github.com/commaai/openpilot/blob/master/openpilot/system/loggerd/loggerd.cc): `openpilot/system/loggerd/loggerd.cc`
- [Data Uploader](https://github.com/commaai/openpilot/blob/master/openpilot/system/loggerd/uploader.py): `openpilot/system/loggerd/uploader.py`

### User Experience

- [Onroad UI](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/ui/layouts/main.py): `openpilot/selfdrive/ui/layouts/main.py`
- [Alert Manager](https://github.com/commaai/openpilot/blob/master/openpilot/selfdrive/selfdrived/alertmanager.py): `openpilot/selfdrive/selfdrived/alertmanager.py`
- [WiFi Manager](https://github.com/commaai/openpilot/blob/master/openpilot/system/ui/lib/wifi_manager.py): `openpilot/system/ui/lib/wifi_manager.py`

### Analysis Tools

- [CAN Analyzer](https://github.com/commaai/openpilot/blob/master/openpilot/tools/cabana/ui/main.cc): `openpilot/tools/cabana/ui/main.cc`
- [Remote Routes](https://github.com/commaai/openpilot/blob/master/openpilot/tools/cabana/ui/dialogs/routesdialog.cc): `openpilot/tools/cabana/ui/dialogs/routesdialog.cc`
- [Route Replay](https://github.com/commaai/openpilot/blob/master/openpilot/tools/replay/main.cc): `openpilot/tools/replay/main.cc`
- [Log Explorer](https://github.com/commaai/openpilot/blob/master/openpilot/tools/jotpluggler/app.cc): `openpilot/tools/jotpluggler/app.cc`

### Other components

- **Driver**
- **Supported Car**
- **Comma Cloud**

## Connections

- Process Manager → Persistent Params: initializes
- Process Manager → Comma Cloud: registers device
- Process Manager → Camera Daemon: starts process
- Process Manager → Sensor Daemon: starts process
- Process Manager → Panda Daemon: starts process
- Camera Daemon → Messaging Bus: publishes frames
- Sensor Daemon → Messaging Bus: publishes sensors
- GPS Daemon → Messaging Bus: publishes GPS
- Panda Daemon → Messaging Bus: publishes CAN
- Messaging Bus → Driving Model: delivers frames
- Messaging Bus → Localization: delivers sensors
- Driving Model → Messaging Bus: publishes predictions
- Localization → Messaging Bus: publishes pose
- Motion Planner → Messaging Bus: publishes plan
- Vehicle Controller → Panda Daemon: sends commands
- Driver → Onroad UI: operates interface
- Onroad UI → Messaging Bus: publishes bookmarks
- Alert Manager → Persistent Params: stores alerts
- Drive Logger → Messaging Bus: records streams
- Data Uploader → Comma Cloud: uploads driving data
- WiFi Manager → Comma Cloud: connects network
- Remote Routes → Comma Cloud: fetches routes
- CAN Analyzer → Route Replay: loads route data
- Log Explorer → Comma Cloud: streams routes
- Supported Car → Panda Daemon: exchanges CAN
