Skip to main content

Beyond ADAS — collision anticipation inference for dashcam video

Project description

BADAS - Beyond ADAS

Python 3.10+ PyTorch 2.0+ PyPI

BADAS (Beyond ADAS) is a deep learning framework for predicting collision likelihood in dashcam video sequences. It supports multiple vision transformer backbones and deployment formats optimized for real-time inference.

Installation

pip install badas

Optional extras for faster video decoding or alternative backends:

pip install decord           # Fast video decoding (falls back to OpenCV)
pip install onnxruntime-gpu  # ONNX backend

Quick Start

from badas.inference import BADAS, BADASConfig

predictor = BADAS.from_pretrained("nexar-ai/BADAS-Open")

# Batch prediction on a video
results = predictor.predict_video("dashcam.mp4", stride=1)
for r in results:
    print(f"[{r['timestamp']:.2f}s]  {r['risk_level']:<6}  p={r['probability']:.3f}")

# Streaming / moving-window inference
for pred in predictor.predict_stream("dashcam.mp4", stride=1):
    if pred['probability'] > 0.7:
        print(f"WARNING: High collision risk at {pred['timestamp']:.2f}s")

Prediction Output

Each prediction is a dict:

{
    'frame_index': 100,
    'timestamp': 4.17,
    'probability': 0.823,
    'risk_level': 'high',   # 'low' | 'medium' | 'high'
    'smoothed': True,
}

Inference Backends

Format Load Notes
.ckpt / .pt BADAS("model.ckpt") Full model + config, supports torch.compile
.onnx BADAS("model.onnx") CPU/GPU via ONNX Runtime
.trt / .engine BADAS("model.trt") NVIDIA GPU, lowest latency

Configuration

from badas.inference import BADAS, BADASConfig, SmoothingConfig

config = BADASConfig(
    use_compile=True,       # torch.compile — slow first run, fast thereafter
    startup_ramp=True,      # yield predictions before the full window is buffered
    smoothing=SmoothingConfig(
        enabled=True,
        alpha_rise=0.7,     # smoothing when risk increases
        alpha_fall=0.3,     # smoothing when risk decreases
    ),
)
predictor = BADAS("model.ckpt", config=config)

Available Models

Open Source

Model Size Notes
nexar-ai/BADAS-Open ViT-L Publicly available
predictor = BADAS.from_pretrained("nexar-ai/BADAS-Open")

Commercial (Nexar)

Model Size Notes
nexar-ai/badas-1.0 ViT-L
nexar-ai/badas-1.5 ViT-L Best accuracy
nexar-ai/badas-1.5-flash ViT-B Fast
nexar-ai/badas-1.5-flash-lite ViT-S Fastest

To request access, visit nexar-ai.com/badas.

Citation

@article{goldshmidt2025badas,
  title={BADAS: Context Aware Collision Prediction Using Real-World Dashcam Data},
  author={Goldshmidt, Roni and Scott, Hamish and Niccolini, Lorenzo and
          Zhu, Shizhan and Moura, Daniel and Zvitia, Orly},
  journal={arXiv preprint},
  year={2025}
}

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

badas-1.1.0.tar.gz (225.1 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

badas-1.1.0-py3-none-any.whl (241.9 kB view details)

Uploaded Python 3

File details

Details for the file badas-1.1.0.tar.gz.

File metadata

  • Download URL: badas-1.1.0.tar.gz
  • Upload date:
  • Size: 225.1 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.9

File hashes

Hashes for badas-1.1.0.tar.gz
Algorithm Hash digest
SHA256 b61fb305708da07a314328c42151e8782900cd935142192d8cd5b429eef056fd
MD5 50b7039cf8e0374c8f0c5a82c56a6b92
BLAKE2b-256 5c9c7c2425f8814de8240420d5b1a071f3325cb8d997f013fe67594d6f24a5c5

See more details on using hashes here.

File details

Details for the file badas-1.1.0-py3-none-any.whl.

File metadata

  • Download URL: badas-1.1.0-py3-none-any.whl
  • Upload date:
  • Size: 241.9 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.10.9

File hashes

Hashes for badas-1.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 200db11cb9d6bd3d5183f3ce7c3ab9450167898b5c4de3d4d69ba7d428f9f496
MD5 8c9d924f4f8d9cb710a961ded41c2939
BLAKE2b-256 f817a4892adf2351932d738965bd8376d690d4542e3298e9ceec319a747bc816

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page