Windows Installation

1. Open the releases page of the AI Detector project with the button above, or search Google for “CowCatcher AI GitHub” and click Releases in the right-hand menu.
2. Download exactly two files: the AI engine that matches your graphics card, and the web version (aidetector-web-windows) — the interface where you set everything up.

For the standard winml version you can download without an account. For the NVIDIA (CUDA) builds GitHub requires you to be signed in: go to github.com, click Sign in and choose ‘Continue with Google’ to use your existing Google account. That takes a few seconds.

1. Right-click an empty spot on your desktop and choose New → Folder. Give it the clear name Cowcatcher.
2. Open File Explorer, go to Downloads and select both .zip files. Press Ctrl + X, open the Cowcatcher folder and press Ctrl + V.
3. Right-click the first zip file and choose Extract All…, then confirm. Do exactly the same for the second zip file.
4. Both programs are now unpacked in the folder. You can safely delete the original .zip files.

CowCatcher AI is not distributed through the Microsoft Store, so Windows shows a security warning as a precaution. Two short actions remove it for good.

A — Unblock the files

1. Right-click the program (.exe) and choose Properties at the very bottom.
2. On the General tab, under Security, you see the text: “This file came from another computer and might be blocked to help protect this computer.”
3. Tick Unblock, click Apply and then OK. Do this for both programs.

B — Get past Windows SmartScreen

1. The first time you open the program a blue screen may appear saying “Windows protected your PC” (Windows Defender SmartScreen).
2. Click the small link More info and then the button Run anyway that appears. The program now has full permission.

RTSP (Real Time Streaming Protocol) is the network address your IP cameras use to send their live video over the local network. CowCatcher AI reads that stream and analyses it frame by frame.

Settings per camera brand

• Reolink — RTSP is switched off at the factory, so you have to enable it once. Open the Reolink app on your computer or phone, select the camera, tap the gear icon and go to Network → Advanced → Server Settings. Tick RTSP and save. Confirm with Yes when the camera asks if you are sure.
• Hikvision & Dahua — RTSP is already enabled by default. You do not have to change anything in the camera software.
• Axis, Foscam, Ubiquiti UniFi — also allow RTSP streaming out of the box, on the standard port 554.

Find the IP address of your camera

You need the IP address of the camera to connect it. You will find it in the camera's mobile app, on the network page of your router, or in the software of the camera brand. An IP address almost always looks like 192.168.1.31 or 192.168.178.50.

Always use the substream

Nearly every IP camera sends out two video streams: a mainstream in high resolution (4K or 1080p) that costs a lot of computing power, and a substream in a lower resolution (640x480 or 720p). For the AI the substream is more than sharp enough to recognise cows, mounting behaviour and calving activity — and it saves up to 80% of the load on your processor. Always pick the substream.

1. Open the folder of the web version and start the application. Your browser opens the local user interface.
2. If your browser or firewall asks for network access, choose Allow.
3. Go to Streams and click Add.
4. Enter a clear Label, for example Heifers barn 1 or Calving pen west.
5. Paste the RTSP address of the camera in the Source field. Use the template for your brand below.
6. Click Test. If the connection succeeds you immediately see the live camera image.
7. Click Save, and repeat these steps for every camera you want to add.

Find the RTSP URL for your camera

Replace [PASS] and [IP] with the password and IP address of your own camera. Prefer the Sub stream where available — it uses far less processing power.

Telegram is the fastest and cheapest way to receive alerts on your phone, including the photo of the detection.

1. Go to Notifications and click Add → Telegram.
2. Give the channel a Label, for example My phone or Family group.
3. Fill in the Token of your bot. You get this from Telegram’s BotFather when you create your own notification bot.
4. Fill in your Chat ID: a unique ten-digit number (for example 1234567890) that tells the bot which account or group chat the photos must go to.
5. Click Test notification and check your phone. Did the test message arrive? Then click Save.

Several notification groups

You can add as many Telegram recipients or groups as you like. A practical split: one group Heat detection heifers for the farmer and the staff, and a second group Calving alerts for the whole family or the night shift.

Home Assistant webhook (optional)

Do you use Home Assistant on the farm? Then you can also enter a webhook URL. CowCatcher AI sends a JSON signal to your Home Assistant server on every detection, so you can switch on the barn lighting automatically or trigger a physical siren relay.

In the Detectors tab you create the actual AI jobs: here you link the cameras, the type of detection and the settings together.

Heat detection (Cow Catcher)

1. Click Add and choose the preset Cow Catcher (heat detection / mounting).
2. Select the streams that are aimed at the cows or heifers in heat.
3. Select the Telegram channels that must receive a message when a mount is detected.
4. Set the Confidence (see the table below) and click Save.

Calving detection (Calving Catcher)

1. Click Add and choose the preset Calving Catcher.
2. Select the camera(s) of the calving pen or the straw boxes, plus the Telegram channels for calving alerts.
3. With calving you do not want any delay, so set the alert interval to 1: every detection is sent through immediately.
4. Set Required detected frames to about 15. The AI checks roughly once per second, so 15 seconds of continuous signal (feet or water bag) sets off the alarm.

Confidence explained

The confidence decides how sure the AI has to be of its case before an alert is sent.

Advanced parameters

Behind the Advanced switch you will find extra parameters such as the detection interval, timeouts and video export. Everything you save here is written automatically to the config.json file in your program folder — you never have to edit that file by hand.

See what every setting does →

1. Open the Cowcatcher folder and start the AI detector — the engine, not the web interface.
2. A dark terminal window opens. Do not close this window! This is the engine that processes all the camera images in the background.
3. On the very first start the program downloads the latest AI model from the server. Depending on your internet speed this takes one to three minutes. It then converts the model automatically to the fastest format for your hardware.

Reading the log

Once the AI is active you see a line scroll by for every processed frame, with the detection time in milliseconds. As long as those lines keep coming, you know the AI is watching your barn live.

aidetector.detection.detector - INFO - Detection time: 38ms for 1 frame(s). Avg: 38ms
aidetector.detection.detector - INFO - Detection time: 37ms for 1 frame(s). Avg: 37ms
aidetector.detection.detector - INFO - Checking for timeouts