Repository navigation
Getting started
Before installing, understand the project or try the dashboard in your browser. The demo uses synthetic scenes and scripted answers; no Jetson, camera or model is connected. It is an interface demonstration, not a device or recognition test.
Use the v2.0.0-beta.1 release. For a Jetson installation, download the tester archive and its checksum file from the release's Assets list. GitHub's automatic source ZIP/tarball is source code, not the prepared tester package.
The complete, version-pinned instructions are in the installer QUICKSTART and inside the archive. Read its prerequisites before starting.
| Item | Published beta.1 asset |
|---|---|
| Archive | sentinel-personal-beta-949da67-mod960fcc3-r9.tar.gz |
| Checksum file | sentinel-personal-beta-949da67-mod960fcc3-r9.tar.gz.sha256 |
| Archive size | 722,378 bytes; 126 files |
| SHA-256 | 3b5dde56d1926d6be5391bf8a49c313ca952f8693452c56ebf334bf3929f2d1c |
| Application version | 2.0.0b1 |
On the Jetson, in the directory containing both downloaded files:
sha256sum -c sentinel-personal-beta-949da67-mod960fcc3-r9.tar.gz.sha256Continue only if the result is OK:
tar -xzf sentinel-personal-beta-949da67-mod960fcc3-r9.tar.gz
cd sentinel-personal-beta-949da67-mod960fcc3-r9
bash preflight.shPreflight reads the platform; it does not open the camera or install anything.
The reference device has L4T R36.4.7 with an Ubuntu 24.04 userland. Stock JetPack 6 / Ubuntu 22.04 and other
Jetsons have not been verified. The documented --accept-unverified-platform option is an explicit opt-in,
not a compatibility result. The package installs under your own account; system prerequisites may need separate
administrator installation.
Follow the guide in this order:
| Stage | What happens |
|---|---|
| Install |
install.sh creates a separate installation and data directory; no service starts |
| Environment and downloads | Pinned Python dependencies and upstream model files, checked by SHA-256 |
| Guarded builds | llama.cpp and the TensorRT engine are built on your device; these steps use device resources |
| Your enrollment | Your own consented photos create a sealed gallery; the face model runs, and enrollment copies are deleted after success |
| Configure, record and check | Record your device artifacts, then check with --device-artifacts FILE
|
| Launch |
start.sh --device-artifacts FILE; typing START at its final prompt permits the camera to open
|
| Stop | Ctrl-C once, wait for OBS_exit; recovery uses stop.sh
|
The default artifact admission is tied to the reference device's files. A tester must use the documented opt-in device-artifacts route with their own builds and enrollment. A successful artifact check identifies those files; device resource validation remains pending. Do not copy a maintainer's private launcher, gallery or build files, or change file times to pass a check.
Build memory matters: one headless engine export completed in 187 seconds, starting with 6.95 GB free. Earlier attempts failed or were stopped. This is one observation, not a minimum-memory or completion-time guarantee. Use the guide's guarded build procedure.
The package contains no models, engines, credentials, enrollment or camera recordings. Snapshots and external notifications are off in its supplied launch profile. See Status and limitations for the rehearsal's scope and what remains untested.
After completing the install, builds, enrollment and checks, use Dashboard and controls for the exact tunnel, launch and stop commands. Only the launch's final START opens the camera; reading this Wiki, downloading, installing and checking do not.
This uses source code rather than the tester archive. Python 3.10 or newer; no camera, GPU or model needed:
git clone --branch v2.0.0-beta.1 https://github.com/hemkesh2021-dotcom/Sentinel_Surveillance.git
cd Sentinel_Surveillance
python3 -m venv .venv
. .venv/bin/activate
python -m pip install -e '.[dev]'
python -m pytest
sentinel config validate config/default.yaml
sentinel --version # sentinel 2.0.0b1Browser tests run when a Chromium-family browser is available. For contributions, branch from current master
and follow CONTRIBUTING.md.
Portable checks do not establish hardware compatibility or recognition accuracy.
Use the installation issue form for installer problems. Include the package revision, platform and short error text. The tracker is public: omit credentials, camera addresses, control keys, photos, galleries, footage and whole logs.
Sentinel v2.0.0-beta.1
Downloads and help
- Project website
- Try the dashboard (synthetic demo)
- Beta release and installer
- Installer guide
- README and dashboard GIF
- Installation issue
- Contributing
- Security policy
Earlier releases