Cowcatcher

Cowcatcher

<p align="left"> <a href="https://jacobsfarm.github.io/website/"><img src="https://img.shields.io/badge/Website-cowcatcherai.com-blue?logo=googlechrome&logoColor=white" alt="Website"></a> <a href="https://huggingface.co/spaces/CowcatcherAI/CowCatcherAI"><img src="https://img.shields.io/badge/🤗%20Hugging%20Face-Spaces-yellow" alt="Hugging Face"></a> <a href="https://t.me/+SphG4deaWVNkYTQ8"><img src="https://img.shields.io/badge/Telegram-Join%20Chat-2CA5E0?logo=telegram&logoColor=white" alt="Telegram"></a> <a href="https://github.com/eschouten/ai-detector"><img src="https://img.shields.io/badge/GitHub-AI--Detector-181717?logo=github&logoColor=white" alt="AI-Detector Repo"></a> <a href="https://github.com/CowCatcherAI/CowCatcherAI"><img src="https://img.shields.io/badge/GitHub-CowCatcherAI-181717?logo=github&logoColor=white" alt="CowCatcherAI Repo"></a> <a href="https://github.com/CowCatcherAI/CalvingCatcherAI"><img src="https://img.shields.io/badge/GitHub-CalvingCatcherAI-181717?logo=github&logoColor=white" alt="CalvingCatcherAI Repo"></a> </p>

Check out the website for all the information: cowcatcherai.com The website is available in multiple languages such as Deutsch, Français, Nederlands, and Español.

Cowcatcher is a vision model that detects mounting behaviour in cattle from camera images. Mounting is one of the clearest visual signals that a cow is in heat, so a reliable detector lets a barn camera flag oestrus automatically instead of relying on someone watching the herd.

All models are single-class (mounting) Ultralytics models, trained at 640 px on farm camera footage from multiple dairy and beef sites, in daylight, night/IR and robot-barn conditions.

Latest and best model: cowcatcherV17.2.pt. It is the only model in the comparison that produces zero false alarms on the null set, at any threshold from 0.50 upward.

---

Available models

All six detection models are published here and all six appear in the benchmark tables below.

---

Quick start

pip install ultralytics

from ultralytics import YOLO

model = YOLO("cowcatcherV17.2.pt")

# Single image
results = model.predict("barn_frame.jpg", conf=0.50)

for r in results:
    for box in r.boxes:
        print("mounting", float(box.conf), box.xyxy.tolist())

# Live camera / RTSP stream
for result in model.predict(source="rtsp://camera/stream", stream=True, conf=0.50):
    if len(result.boxes):
        print("Mounting detected")

Which confidence threshold?

For cowcatcherV17.2 the false-positive count stays at 0 across the entire 0.50–0.99 sweep, so the threshold only trades away recall. F1 peaks at 0.50; anything up to ~0.80 is still a sensible operating point if you want extra headroom.

---

Training

Every model in this repository was trained with the same script (train.py) — only the base checkpoint and the epoch count change per version.

from ultralytics import YOLO

# Load model
model = YOLO("yolo26m.pt")

# Train with added augmentation
model.train(
    data="dataset.yaml",
    imgsz=640,
    batch=16,
    epochs=50,
    patience=10,
    #fraction=0.05, # currently uses 100% of the dataset; 0.8 = 80% of the set
    save_period=5,
    workers=0,
    device=0,
    #close_mosaic=10,

    # Augmentation settings
    augment=True,      # General augmentation on/off
    degrees=10,        # Rotation up to 10 degrees
    translate=0.1,     # Translation up to 10%
    scale=0.5,         # Scaling between 0.5 and 1.5
    fliplr=0.5,        # 50% chance of horizontal flip
    hsv_h=0.015,       # Minor hue variations
    hsv_s=0.7,         # Saturation variations
    hsv_v=0.4,         # Brightness variations
    mosaic=1.0         # Mosaic augmentation (combines 4 images)
)

Per-version settings — everything else in the script stays identical:

dataset.yaml points at the single-class (mounting) farm-camera dataset, which is not published here. patience=10 stops a run early once validation stops improving, so the effective epoch count can be lower than the number listed. Training ran on a single GPU (device=0), with workers=0 for Windows compatibility.

---

Benchmark

Test set: 1000 held-out images — 900 real mounting events and 100 null/noise images (cattle, barns and robots without mounting). Six models evaluated on 2026-07-23.

Of the 900 mounting events, 11 are found by no model at 0.88, and 536 are missed by at least one model.

Performance at threshold 0.88

Note that 0.88 is a legacy production threshold. It suits V16, but it sits far above the optimum for V17.2 — see the next table.

Best achievable operating point (max F1)

Confidence separation

The gap between the mean confidence on real mounts and on null images decides how easy the model is to threshold. V17.2 is in a different class here: it is almost silent on noise (mean 0.008) while staying confident on real events (mean 0.918).

The same effect shows in the safety margin (5th percentile of real mounts minus 95th percentile of nulls). Every other model is negative — its distributions overlap — while V17.2 reaches +0.827:

Confidence distribution on null images

Number of null images falling in each confidence bin — lower and further left is better.

---

Choosing a model

• Default choice — cowcatcherV17.2. Best F1, zero false alarms, widest usable threshold window. Pick this unless you have a specific reason not to.
• cowcatcherV16 still has the highest raw recall at the legacy 0.88 threshold, but pays for it with 21 false alarms out of 100 nulls and heavily overlapping confidence distributions.

Limitations

• Single class only: the model detects mounting, not cow identity, lameness or other behaviours.
• Trained and evaluated on fixed barn cameras. Very different mounting angles, heavy occlusion or unusual camera placements are under-represented.
• The 100-image null set is small; a false-positive rate of 0 on it should be read as "no false alarms observed", not as a guarantee.
• Benchmark timings (24–29 ms/image) were measured on the evaluation machine and will differ on other hardware.

License

AGPL-3.0.

These weights are trained with Ultralytics, which is licensed under AGPL-3.0. Every checkpoint in this repository carries the Ultralytics AGPL-3.0 notice in its metadata, so the derived weights inherit that license.

In practice this means that if you use these models in a network-accessible service, AGPL-3.0 requires you to make the corresponding source of that service available to its users. If that does not work for your deployment, Ultralytics sells a commercial Enterprise License that removes the copyleft obligation — see ultralytics.com/license.