Sky Tracker SDK

C++ tracking core for fast-moving small objects — drone, aircraft, bird detection and tracking. No GPU required.

Install

pip install sky-tracker-sdk

License

A valid license key is required at runtime. Set it as an environment variable:

# Windows
set SKY_TRACKER_LICENSE_KEY=SKT1.<your-token>

# Linux / macOS
export SKY_TRACKER_LICENSE_KEY=SKT1.<your-token>

Or drop a sky_tracker.lic file next to your script — the SDK finds it automatically.

Quick Start

import cv2
import sky_tracker

cap = cv2.VideoCapture("video.mp4")
ok, frame = cap.read()

tracker = sky_tracker.Tracker("default")
tracker.lock(frame, (469, 409, 26, 38))  # x, y, w, h

while cap.isOpened():
    ok, frame = cap.read()
    if not ok:
        break
    result = tracker.update(frame)
    if not result.lost:
        cx, cy = result.center()
        print(f"frame target at ({cx:.1f}, {cy:.1f})  confidence={result.confidence:.2f}")

Tracker Profiles

For default and adaptive, automatic search uses the initial box's longest side: 64 pixels up to 16 px, 128 pixels through 80 px, and 256 pixels above 80 px. correlation retains its v0.1.12 sizing: 128 pixels through 80 px and 256 above 80 px. The quality profiles use their own 128/256 search policy and stricter evidence thresholds. They are optional; existing profile names retain the same tracking behavior. See quality engine details.

The default profile includes foreground box fitting, so neither a profile nor a search flag is needed. adaptive retains color contrast and appearance scoring. --target-correlation-search remains an optional override. See adaptive geometry stability and validation and default profile performance.

Version 0.2.0 changes the default tracking behavior. To retain the previous default, use CLI --profile legacy, Python sky_tracker.Tracker("legacy") (or set TrackerConfig.profile = "legacy"), or Node { profile: "legacy" } with the 0.2.2 runtime. Existing Pi profile aliases still select the improved default. See 0.2.2 release notes and the 0.2.0 migration guide.

Older profile names remain accepted as deprecated compatibility aliases but are not part of the public profile API.

Platforms

Links

• Python quickstart
• Node.js SDK

Native SDK and platform builds

The C++ SDK accepts borrowed Gray8, Bgr8, or Rgb8 frames through an OpenCV-free public header and exports an installed CMake target. The Android binding accepts camera Y-plane buffers, and the Jetson build script prepares CPU binaries for JetPack 4. Android and Jetson need validation on their target devices before release.