we write it ourselves

pyproject.toml

@@ -8,6 +8,12 @@ authors = [
   {name = "Vehicle Researcher", email="user@comma.ai"}
 ]
 
+# ------------------------------------------
+# > this dependencies list *only* goes down.
+# ------------------------------------------
+# Linux and Python is all we need, otherwise
+# we write and own the lines ourselves.
+# ------------------------------------------
 dependencies = [
   # multiple users
   "sounddevice",  # micd + soundd

tools/setup_dependencies.sh

@@ -38,7 +38,11 @@ function install_linux_deps() {
     fi
   done
 
-  # normal stuff, this mostly for bare docker images
+  # ------------------------------------------------
+  # dependencies should never be added to this list.
+  # these are only for inflating bare docker images
+  # to their desktop equivalents.
+  # ------------------------------------------------
   if [[ "$missing_linux_deps" -eq 0 ]]; then
     # the native package managers are slow, so skip if we can
     echo "[ ] system packages already installed t=$SECONDS"