a central repo for managing and vendoring third party dependencies for all comma projects.
since all our projects are Python, we wrap each vendored dependency as a pip package. git clone and uv sync is all you need.
motivations for this approach
apt-getis slowapt-getupdates its packages on a schedule we don't controlapt-getpackage versions don't matchbrewversionsapt-getdoesn't come with Arch Linuxapt-getdoesn't always have the exact package we needapt-getpackages are often bloated
uv, as opposed to apt-get, brew, and friends, is fast and already used in our projects.
we target the following platforms:
- Linux x86_64
- Linux aarch64
- Darwin aarch64 (Apple Silicon)
contributions welcome for other platforms!
| package | description |
|---|---|
| gcc-arm-none-eabi | builds panda firmware for STM32 MCUs |
| capnproto | message serialization for openpilot |
| ffmpeg | video encode and decode for openpilot |
| git-lfs | for tracking large files in openpilot |
| zeromq | bridging the openpilot IPC between different hosts |
dependencies = [
"capnproto @ git+https://github.com/commaai/dependencies.git@releases#subdirectory=capnproto",
"ffmpeg @ git+https://github.com/commaai/dependencies.git@releases#subdirectory=ffmpeg",
]to add a new package:
- start a new top-level directory as a new package
./test.shtests the building of all packages- on pushes to
master, wheels are built for our target platforms and pushed to a GitHub release - the
releasesbranch contains shim packages that allow pointing to a git branch and always getting the appropriate wheel for your platform