Argus is an edge-optimized Tesla Dashcam and Sentry Mode manager implemented as a single Go binary with an embedded web UI. It is designed for unattended, in-car operation with low CPU and RAM footprint.

Argus turns a Raspberry Pi into a Tesla-compatible multi-LUN USB storage device while also exposing a local web UI for management:

• Presents TeslaCam/LightShow/Music storage over USB gadget mode
• Supports mode switching between:
  • Present mode (Tesla-facing USB gadget)
  • Edit mode (RW mounts + Samba/file management)
• Provides a web interface for:
  • videos/events browsing
  • chimes/lightshows/wraps/music management
  • cleanup and analytics
  • runtime settings
• Includes unattended reliability features:
  • startup boot pipeline
  • optional fsck checks
  • optional cleanup
  • optional random chime selection
  • hardware watchdog integration
  • AP fallback and Wi-Fi monitoring
  • Telegram alerting for Sentry events (when configured)

• Backend: Go (USB gadget, mounts, loops, Samba orchestration, AP/Wi-Fi, Telegram, scheduler)
• Frontend: Next.js static export embedded in the Go binary
• Delivery model: single self-contained executable
• Configuration: single config.yaml source of truth

• Raspberry Pi Zero 2 W (primary target)
• microSD with enough space for OS + image files
• Reliable data USB cable (not charge-only)

Argus is intended to run on Raspberry Pi OS Lite for unattended deployments.

• Linux kernel with USB OTG gadget support (dwc2, libcomposite, configfs)
• systemd
• root privileges for setup/system operations

cmd/argus/        Go entrypoint + CLI commands
internal/         API, services, system integrations
web/              Next.js frontend source
config.yaml       Generated runtime configuration
Makefile          Build/test orchestration

argus run [--config path]
argus generate [--output path] [--force]
argus setup [--dir path] [--show-size 10G] [--music-size 32G]
argus upgrade [--yes]
argus remove [--yes] [--keep-images]
argus version

Install the latest binary and run setup:

curl -fsSL https://github.com/ulm0/argus/releases/latest/download/argus_$(uname -s | tr '[:upper:]' '[:lower:]')_$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/;s/armv7l/armv7/;s/armv6l/armv6').tar.gz | sudo tar -xz -C /usr/local/bin argus

argus generate
sudo argus setup

Or download manually from the latest releases page.

make deps
make all
make test

Frontend dev:

cd web
pnpm dev

Backend dev:

go run ./cmd/argus run config.yaml

All runtime settings are in ~/.argus/config.yaml.

argus setup generates unattended-friendly defaults:

• installation.boot_present_on_start: true
• installation.boot_block_until_ready: true
• installation.boot_cleanup_on_start: true
• installation.boot_random_chime_on_start: false
• disk_images.boot_fsck_enabled: true
• system.watchdog_enabled: true
• system.watchdog_timeout_sec: 60
• system.reapply_sysctl_on_start: true

The Settings page includes a Startup & Reliability section:

• Present on startup
• Block startup until boot pipeline completes
• Boot cleanup
• Random chime on startup
• Boot fsck checks
• Watchdog enable + timeout
• Sysctl profile re-apply on startup

Some changes take effect on next service restart or reboot.

• Multi-LUN presentation for TeslaCam + optional partitions
• RO local mounts in Present mode for safe read access
• RW mounts in Edit mode for management operations
• Safe mode transition sequencing (unmount/loop/gadget orchestration)

• Video browsing and event handling
• Chime management and scheduling
• Lightshow and wraps management
• Music file management (optional partition)
• Cleanup policies and analytics

• AP fallback on connectivity loss
• Wi-Fi status monitoring
• Telegram event queue and delivery
• Optional watchdog to recover from hangs

Argus is heavily based on TeslaUSB concepts and workflow.
Huge thanks to the TeslaUSB project and contributors.

See repository files for license information.