• Why
• Requirements
• Installation
• Usage
• Documentation
• License

Why does this repository exist?

Because this repository https://github.com/gyonluks/go-darknet is no longer maintained.

What is purpose of this bindings when you can have GoCV (bindings to OpenCV) and it handle Darknet YOLO perfectly?

Well, you don't need bunch of OpenCV dependencies and OpenCV itself sometimes.

Example of such project here: https://github.com/LdDl/license_plate_recognition#license-plate-recognition-with-go-darknet---- .

You need to install fork of darknet. Latest commit I've tested is here. It corresponds last official YOLOv4 release

Use provided Makefile.

• For CPU-based instalattion:

  make install_darknet

• For both CPU and GPU-based instalattion if you HAVE CUDA installed:

  make install_darknet_gpu

  Note: I've tested CUDA 10.2 and cuDNN is 7.6.5)

• For both CPU and GPU-based instalattion if you HAVE NOT CUDA installed:

  make install_darknet_gpu_cuda

  Note: There is some struggle in Makefile for cuDNN, but I hope it works in Ubuntu atleast. Do not forget provide proper CUDA and cuDNN versions.

go get github.com/LdDl/go-darknet

Example Go program is provided in the examples directory. Please refer to the code on how to use this Go package.

Building and running program:

• Navigate to examples folder

  cd ${YOUR PATH}/github.com/LdDl/go-darknet/cmd/examples

• Download dataset (sample of image, coco.names, yolov4.cfg (or v3), yolov4.weights(or v3)).

  #for yolo v4
  ./download_data.sh
  #for yolo v3
  ./download_data_v3.sh

• Note: you don't need coco.data file anymore, because sh-script above does insert coco.names into 'names' field in yolov4.cfg file (so AlexeyAB's fork can deal with it properly) So last rows in yolov4.cfg file will look like:

  ......
  [yolo]
  .....
  iou_loss=ciou
  nms_kind=greedynms
  beta_nms=0.6
  
  names = coco.names # this is path to coco.names file

• Also do not forget change batch and subdivisions sizes from:

  batch=64
  subdivisions=8

  to

  batch=1
  subdivisions=1

  It will reduce amount of VRAM used for detector test.

• Build and run example program Yolo V4:

  go build -o base_example/main base_example/main.go && ./base_example/main --configFile=yolov4.cfg --weightsFile=yolov4.weights --imageFile=sample.jpg

  Output should be something like this:

  traffic light (9): 73.5040% | start point: (238,73) | end point: (251, 106)
  truck (7): 96.6401% | start point: (95,79) | end point: (233, 287)
  truck (7): 96.4774% | start point: (662,158) | end point: (800, 321)
  truck (7): 96.1841% | start point: (0,77) | end point: (86, 333)
  truck (7): 46.8694% | start point: (434,173) | end point: (559, 216)
  car (2): 99.7370% | start point: (512,188) | end point: (741, 329)
  car (2): 99.2532% | start point: (260,191) | end point: (422, 322)
  car (2): 99.0333% | start point: (425,201) | end point: (547, 309)
  car (2): 83.3920% | start point: (386,210) | end point: (437, 287)
  car (2): 75.8621% | start point: (73,199) | end point: (102, 274)
  car (2): 39.1925% | start point: (386,206) | end point: (442, 240)
  bicycle (1): 76.3121% | start point: (189,298) | end point: (253, 402)
  person (0): 97.7213% | start point: (141,129) | end point: (283, 362)

  Yolo V3:

  go build main.go && ./main --configFile=yolov3.cfg --weightsFile=yolov3.weights --imageFile=sample.jpg
  

  Output should be something like this:

  truck (7): 49.5123% | start point: (0,136) | end point: (85, 311)
  car (2): 36.3694% | start point: (95,152) | end point: (186, 283)
  truck (7): 48.4177% | start point: (95,152) | end point: (186, 283)
  truck (7): 45.6520% | start point: (694,178) | end point: (798, 310)
  car (2): 76.8402% | start point: (1,145) | end point: (84, 324)
  truck (7): 25.5920% | start point: (107,89) | end point: (215, 263)
  car (2): 99.8782% | start point: (511,185) | end point: (748, 328)
  car (2): 99.8193% | start point: (261,189) | end point: (427, 322)
  car (2): 99.6405% | start point: (426,197) | end point: (539, 311)
  car (2): 74.5627% | start point: (692,186) | end point: (796, 316)
  car (2): 72.7975% | start point: (388,206) | end point: (437, 276)
  bicycle (1): 72.2760% | start point: (178,270) | end point: (268, 406)
  person (0): 97.3007% | start point: (143,135) | end point: (268, 343)

See go-darknet's API documentation at GoDoc.

go-darknet follows Darknet's license.