git404hub

what is womprat fr?

punklabs-ai/womprat — explained in plain English

Analysis updated 2026-05-18

15PythonAudience · developerComplexity · 4/5LicenseSetup · moderate

tl;dr

A CPU-only classical computer vision tracker that locks onto and follows a single small drone across video frames, no GPU needed.

vibe map

mindmap
  root((repo))
    What it does
      Tracks single drone
      Runs CPU only
      Recovers after occlusion
    Tech stack
      Python
      OpenCV
      FastAPI
    Use cases
      Counter-UAS tracking
      Web demo tracking
      Benchmark tuning
    Audience
      Developers
      Computer vision engineers

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

what do people make with this?

VIBE 1

Track a small, distant drone in real time on low power hardware like a Raspberry Pi, no GPU required.

VIBE 2

Run a local web demo to click-select and visually track a drone in an uploaded video clip.

VIBE 3

Benchmark and tune a drone tracker's accuracy against annotated datasets using standard tracking metrics.

what's the stack?

PythonOpenCVFastAPINumPySciPy

how it stacks up fr

punklabs-ai/womprat13127905/deep-learning-based-air-gesture-text-recognition-42kyynfqjv-dot/deepseekradio
Stars151515
LanguagePythonPythonPython
Setup difficultymoderatemoderatehard
Complexity4/53/54/5
Audiencedeveloperdeveloperdeveloper

Figures from each repo's GitHub metadata at analysis time.

how do i run it?

Difficulty · moderate time til it works · 30min

Requires Python 3.10+ and a virtual environment with OpenCV and FastAPI extras installed.

Apache 2.0, use freely including commercially, but datasets and model weights have their own separate terms.

in plain english

Womprat is a tool that watches a video feed and keeps track of a single drone as it moves across the frame, without needing a GPU. It is built for counter drone systems, the kind of setup used to spot and follow small unmanned aircraft that might be far away and only a few dozen pixels wide on screen, even when the sky is cluttered with birds, clouds, or a shaky camera. Once you give it a starting box around the target in the first frame, it locks on and keeps following that same object frame by frame, and it is designed to recover the lock if the drone briefly disappears behind something or the detector misses a few frames. Under the hood it combines several classical computer vision techniques rather than a deep learning model: a blob detector that spots moving shapes, a Kalman filter that predicts where the target should be next based on its motion, a matching step that connects detections to the right track, and some lightweight visual cues to help re-identify the target after it is briefly lost. This combination is tuned to run in real time on modest hardware, such as a quad core Raspberry Pi with no graphics card. Optional YOLO model weights are also included as an alternative detector, if you want to swap in a machine learning based detector instead of the classical one. The project includes a small web based demo, built with FastAPI, where you can upload or pick a video clip, click on the drone to lock onto it, and watch the tracking result overlaid on the video stream in your browser. This demo has no login protection, so it is meant to run only on your own computer or a trusted local network, not exposed to the internet. The repository also ships a full benchmarking system that measures tracking accuracy using standard metrics like ID switches and lost frames, tested against datasets of real drone and bird footage, so that any change to the tracker's tuning can be checked against measured results before being adopted. The code is released under the Apache License 2.0, though the datasets and any downloaded model weights used for testing are not covered by that license and have their own separate terms.

prompts (copy fr)

prompt 1
Help me set up womprat and run the live web demo to track a drone in a sample video.
prompt 2
Show me how to use the womprat Tracker class in Python to lock onto and follow a target across frames.
prompt 3
Explain how the Kalman filter and blob detector work together in this tracker's design.
prompt 4
Walk me through running the benchmark suite in this repo to compare tracker accuracy before and after a change.

Frequently asked questions

what is womprat fr?

A CPU-only classical computer vision tracker that locks onto and follows a single small drone across video frames, no GPU needed.

What language is womprat written in?

Mainly Python. The stack also includes Python, OpenCV, FastAPI.

What license does womprat use?

Apache 2.0, use freely including commercially, but datasets and model weights have their own separate terms.

How hard is womprat to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is womprat for?

Mainly developer.

peek the repo → explain another one

This repo across BitVibe Labs

double-check against the repo, no cap.