# deneb-systems/sky-tracker-sdk architecture

> Architecture diagram of the GitHub repository deneb-systems/sky-tracker-sdk, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-20). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/deneb-systems/sky-tracker-sdk
- Repository: https://github.com/deneb-systems/sky-tracker-sdk

## Overview

Sky Tracker is a CPU-friendly video tracking SDK, not a detector: callers usually provide an initial bounding box, then update a tracker with video frames and read position, identity, motion, and confidence results. Its documented branches include single- and multi-target tracking, selectable profiles with optional NanoTrack, motion-only discovery, and licence checks. The supplied tree contains no SDK implementation files or source excerpts, so runtime components are represented with null paths and edges rely only on README statements; example scripts are shown only where their paths are available.

Main entry points: [`examples/track_video.py`](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_video.py) (Single-video example), [`examples/track_multi_video.py`](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_multi_video.py) (Multi-video example), [`examples/track_from_bbox.py`](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_from_bbox.py) (BBox example)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_inputs["Inputs and setup"]
  node_video["Video frames"]
  node_bbox["Initial bounding boxes"]
  node_example_single["Single-video example<br/>[track_video.py]"]
  node_example_multi["Multi-video example"]
  node_example_bbox["BBox example<br/>[track_from_bbox.py]"]
  node_example_machine["Machine ID example<br/>[machine_id.py]"]
end

subgraph group_tracking["Tracking modes"]
  node_single["Tracker"]
  node_multi["MultiTracker"]
  node_motion["MotionTracker"]
  node_results["Tracking results"]
end

subgraph group_profiles["Tracking profiles"]
  node_default["Default profile"]
  node_correlation["Correlation profile"]
  node_legacy["Legacy-adaptive profile"]
  node_nanotrack["NanoTrack"]
end

subgraph group_licensing["Licence validation"]
  node_license_key["Licence key"]
  node_license_check["Licence validation"]
end

node_caller(("SDK caller"))
node_license_server(("Licence server"))

node_caller -->|"creates and locks"| node_single
node_caller -->|"creates and locks"| node_multi
node_caller -->|"creates"| node_motion
node_video -->|"supplies frames"| node_single
node_video -->|"supplies frames"| node_multi
node_bbox -->|"initializes"| node_single
node_bbox -->|"initializes"| node_multi
node_single -->|"returns updates"| node_results
node_multi -->|"returns updates"| node_results
node_motion -->|"reports motion"| node_results
node_single -->|"selects profile"| node_default
node_single -->|"selects profile"| node_correlation
node_single -->|"selects profile"| node_legacy
node_multi -->|"selects profile"| node_default
node_multi -->|"selects profile"| node_legacy
node_correlation -.->|"optionally adds"| node_nanotrack
node_caller -->|"provides key"| node_license_key
node_license_key -->|"checked at creation"| node_license_check
node_license_check -.->|"confirms trial"| node_license_server
node_example_single -->|"demonstrates"| node_single
node_example_multi -->|"demonstrates"| node_multi
node_example_bbox -->|"demonstrates bbox use"| node_single

click node_example_single "https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_video.py"
click node_example_multi "https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_multi_video.py"
click node_example_bbox "https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_from_bbox.py"
click node_example_machine "https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/machine_id.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_video,node_bbox,node_example_single,node_example_multi,node_example_bbox,node_example_machine toneBlue
class node_single,node_multi,node_motion,node_results toneAmber
class node_default,node_correlation,node_legacy,node_nanotrack,node_license_server toneMint
class node_license_key,node_license_check toneRose
class node_caller toneIndigo
```

## Components

### Inputs and setup

- **Video frames**
- **Initial bounding boxes**
- [Single-video example](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_video.py): `examples/track_video.py`
- [Multi-video example](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_multi_video.py): `examples/track_multi_video.py`
- [BBox example](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/track_from_bbox.py): `examples/track_from_bbox.py`
- [Machine ID example](https://github.com/deneb-systems/sky-tracker-sdk/blob/main/examples/machine_id.py): `examples/machine_id.py`

### Tracking modes

- **Tracker**
- **MultiTracker**
- **MotionTracker**
- **Tracking results**

### Tracking profiles

- **Default profile**
- **Correlation profile**
- **Legacy-adaptive profile**
- **NanoTrack**

### Licence validation

- **Licence key**
- **Licence validation**

### Other components

- **SDK caller**
- **Licence server**

## Connections

- SDK caller → Tracker: creates and locks (evidence: `README.md`)
- SDK caller → MultiTracker: creates and locks (evidence: `README.md`)
- SDK caller → MotionTracker: creates (evidence: `README.md`)
- Video frames → Tracker: supplies frames (evidence: `README.md`)
- Video frames → MultiTracker: supplies frames (evidence: `README.md`)
- Initial bounding boxes → Tracker: initializes (evidence: `README.md`)
- Initial bounding boxes → MultiTracker: initializes (evidence: `README.md`)
- Tracker → Tracking results: returns updates (evidence: `README.md`)
- MultiTracker → Tracking results: returns updates (evidence: `README.md`)
- MotionTracker → Tracking results: reports motion (evidence: `README.md`)
- Tracker → Default profile: selects profile (evidence: `README.md`)
- Tracker → Correlation profile: selects profile (evidence: `README.md`)
- Tracker → Legacy-adaptive profile: selects profile (evidence: `README.md`)
- MultiTracker → Default profile: selects profile (evidence: `README.md`)
- MultiTracker → Legacy-adaptive profile: selects profile (evidence: `README.md`)
- Correlation profile → NanoTrack: optionally adds (evidence: `README.md`)
- SDK caller → Licence key: provides key (evidence: `README.md`)
- Licence key → Licence validation: checked at creation (evidence: `README.md`)
- Licence validation → Licence server: confirms trial (evidence: `README.md`)
- Single-video example → Tracker: demonstrates (evidence: `README.md`)
- Multi-video example → MultiTracker: demonstrates (evidence: `README.md`)
- BBox example → Tracker: demonstrates bbox use (evidence: `README.md`)
