sky-tracker-sdk 0.1.12

Sky Tracker — C++ tracking core with Python and Node.js SDK

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

Profile	Best for
default	Recommended speed/quality balance; grayscale, constrained-CPU policy
correlation	Correlation-led identity and stable selected-object tracking
adaptive	Correlation identity with scheduled foreground bbox fitting

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

Platforms

Platform	Status
Windows x64	Supported
Linux x86_64	Wheel build configured
Raspberry Pi 4/5 ARM64	Wheel build configured; hardware validation required
macOS arm64	Coming soon

Links

• Python quickstart
• Node.js SDK