66 lines
1.7 KiB
Markdown
66 lines
1.7 KiB
Markdown
# Native RTSP Bundle
|
|
|
|
This bundle is for lightweight native deployment on an x86_64 Ubuntu host.
|
|
|
|
## What To Edit
|
|
|
|
Open [`scripts/run.sh`](/Users/zxmacmini1/Documents/人流检测/people_flow_project/scripts/run.sh) and edit only these two lines:
|
|
|
|
```bash
|
|
RTSP_URL="rtsp://..."
|
|
OUTPUT_DIR="/home/x/people/output"
|
|
```
|
|
|
|
## First-Time Setup
|
|
|
|
From the project root:
|
|
|
|
```bash
|
|
sudo bash scripts/install.sh
|
|
```
|
|
|
|
This creates `.venv`, installs Python dependencies, copies the bundled DeepFace weights into `~/.deepface/weights`, installs the `systemd` unit, starts the service, and enables it on boot.
|
|
|
|
## Build An Offline Dependency Pack
|
|
|
|
If you want future installs to avoid re-downloading Python packages:
|
|
|
|
```bash
|
|
./build_wheelhouse.sh
|
|
```
|
|
|
|
This creates a local `wheelhouse/` directory for Ubuntu 24.04 x86_64 + Python 3.12. After that, `./setup_native_venv.sh` will automatically prefer local wheels.
|
|
|
|
## Start The RTSP Task
|
|
|
|
```bash
|
|
sudo systemctl status people-flow.service
|
|
```
|
|
|
|
The service runs in the foreground under `systemd`.
|
|
|
|
## Outputs
|
|
|
|
- Latest half-hour summary: `OUTPUT_DIR/rtsp_stream/latest.json`
|
|
- Historical half-hour summaries: `OUTPUT_DIR/rtsp_stream/windows/`
|
|
- Runtime log: `OUTPUT_DIR/rtsp_run.log`
|
|
|
|
## Chinese Guide
|
|
|
|
- `README_zh.md`
|
|
|
|
## Weights
|
|
|
|
The project expects these local files:
|
|
|
|
- `weights/yolo11n.pt`
|
|
- `weights/deepface/age_model_weights.h5`
|
|
- `weights/deepface/gender_model_weights.h5`
|
|
- `weights/deepface/retinaface.h5`
|
|
|
|
At setup time and each RTSP launch, those `.h5` files are copied into the current user's default DeepFace directory:
|
|
|
|
- `~/.deepface/weights/`
|
|
|
|
That keeps the bundle portable across different unpack paths such as `/home/x/people` and `/home/xiaozheng/people`.
|