Get the software

Set up a camera node

For hosts with a Jetson Orin Nano developer kit, a camera and a GPS receiver. The node runs from a ready-made system image: flash it, plug the parts together and finish setup from your phone.

1. Download the image

   From the latest release, download uapfinder-node-<version>-orin-nano.img.xz (under 2 GB) and its SHA-256 checksum.

2. Write it to a microSD card

   Use balenaEtcher and a 64 GB or larger A2 card. Etcher reads the compressed .img.xz directly and verifies the card afterwards.

3. Follow the build guide

   The step-by-step guide covers the one-time firmware check for new developer kits, the wiring, the enclosure, and claiming the node with the code from your network coordinator.

Get the node image Build guide

Alternative: the command-line installer

Already running NVIDIA JetPack 6? The installer produces the same system as the image, including the setup page. On the Jetson, in a terminal:

sudo apt-get update && sudo apt-get install -y git
git clone https://github.com/coalsi/uapfinder.git
cd uapfinder
sudo ./edge/deploy/jetson/setup.sh

Then claim the node at http://uapfinder.local as in the build guide. To check the detection pipeline from a terminal:

journalctl -u skynet-edge -f        # live status, a line every minute
sudo -u skynet /opt/skynet/venv/bin/skynet-edge bench --config /etc/skynet/edge.yaml

Options and configuration are in the edge guide.

Try it without hardware

A simulated network of six cameras watches three objects with known paths, including a Mach 6 one. It sends real signed messages to a local server, then scores the server's 3D tracks against the truth. You need Python 3.10 or later.

git clone https://github.com/coalsi/uapfinder.git && cd uapfinder
python3 -m venv .venv && .venv/bin/pip install -e ./common -e ./server
export SKYNET_MASTER_KEY=$(.venv/bin/skynet-server keygen) SKYNET_ADMIN_TOKEN=$(openssl rand -hex 24)
export SKYNET_PUBLIC_URL=http://127.0.0.1:8000
.venv/bin/skynet-server serve &
.venv/bin/python tools/simulate_network.py --udp 127.0.0.1:9999 \
    --api http://127.0.0.1:8000 --master-key "$SKYNET_MASTER_KEY" --duration 30

Expect median position errors of roughly 10–20 m, and the hypersonic and high-g objects flagged as such.