Skip to content

Getting started

Hemkesh R edited this page Nov 17, 2026 · 3 revisions

Getting started with beta.1

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.

Install on your own Jetson

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.sha256

Continue 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.sh

Preflight 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.

Tunnel, dashboard and stop

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.

Portable development

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.0b1

Browser 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.

Getting help

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.