Usage🔗

The Go bindings are implemented in the vaccel Go package and are currently a WiP, supporting a subset of the vAccel operations.

Requirements🔗

To use the vaccel Go package you need a valid vAccel installation. You can find more information on how to install vAccel in the Installation page.

This package requires Go 1.20 or newer. Verify your Go version with:
```
go version
```
and update Go as needed using the official instructions.

Using the `vaccel` package🔗

You can use the package in your Go code like any other Go package with:

import "github.com/nubificus/vaccel-go/vaccel"

Running the examples🔗

You can find examples in the examples directory of the repository. The provided examples are similar to the C examples and you must configure vAccel in order to use them.

To run an image classification, like the C classify, set:

export VACCEL_PLUGINS=libvaccel-noop.so

and, assuming vAccel is installed at /usr/local, run with:

$ go run github.com/nubificus/vaccel-go/examples/classify \
      /usr/local/share/vaccel/images/example.jpg
Output(1):  This is a dummy classification tag!
Output(2):  This is a dummy classification tag!

By setting log level to debug:

export VACCEL_LOG_LEVEL=4

you can see the verbose vAccel output, very similar to the C classify output:

$ go run github.com/nubificus/vaccel-go/examples/classify \
      /usr/local/share/vaccel/images/example.jpg
2026.04.29-15:00:35.94 - <debug> Initializing vAccel
2026.04.29-15:00:35.94 - <info> vAccel 0.7.1-93-ebc23b1f
2026.04.29-15:00:35.94 - <debug> Config:
2026.04.29-15:00:35.94 - <debug>   plugins = libvaccel-noop.so
2026.04.29-15:00:35.94 - <debug>   log_level = debug
2026.04.29-15:00:35.94 - <debug>   log_file = (null)
2026.04.29-15:00:35.94 - <debug>   profiling_enabled = false
2026.04.29-15:00:35.94 - <debug>   version_ignore = false
2026.04.29-15:00:35.94 - <debug> Created top-level rundir: /run/user/0/vaccel/co8ekx
2026.04.29-15:00:35.94 - <info> Registered plugin noop 0.7.1-93-ebc23b1f
2026.04.29-15:00:35.94 - <debug> Registered op noop from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op exec from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op exec_with_resource from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op image_classify from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op image_detect from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op image_segment from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op image_pose from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op image_depth from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tf_model_load from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tf_model_unload from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tf_model_run from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tflite_model_load from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tflite_model_unload from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op tflite_model_run from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op torch_model_load from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op torch_model_run from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op torch_sgemm from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op blas_sgemm from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op fpga_arraycopy from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op fpga_vectoradd from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op fpga_parallel from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op fpga_mmult from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op minmax from plugin noop
2026.04.29-15:00:35.94 - <debug> Registered op opencv from plugin noop
2026.04.29-15:00:35.94 - <debug> Loaded plugin noop from libvaccel-noop.so
2026.04.29-15:00:35.94 - <debug> New rundir for session 1: /run/user/0/vaccel/co8ekx/session.1
2026.04.29-15:00:35.94 - <debug> Initialized session 1 with plugin noop
2026.04.29-15:00:35.94 - <debug> session:1 Looking for func implementing op image_classify
2026.04.29-15:00:35.94 - <debug> Returning func for op image_classify from plugin noop
2026.04.29-15:00:35.94 - <debug> [noop] Calling Image classification for session 1
2026.04.29-15:00:35.94 - <debug> [noop] Dumping arguments for Image classification:
2026.04.29-15:00:35.94 - <debug> [noop] model: (null)
2026.04.29-15:00:35.94 - <debug> [noop] len_img: 79281
2026.04.29-15:00:35.94 - <debug> [noop] len_out_text: 256
2026.04.29-15:00:35.94 - <debug> [noop] len_out_imgname: 256
2026.04.29-15:00:35.94 - <debug> [noop] will return a dummy result
2026.04.29-15:00:35.94 - <debug> [noop] will return a dummy result
Output(1):  This is a dummy classification tag!
2026.04.29-15:00:35.94 - <debug> session:1 Looking for func implementing op image_classify
2026.04.29-15:00:35.94 - <debug> Returning func for op image_classify from plugin noop
2026.04.29-15:00:35.94 - <debug> [noop] Calling Image classification for session 1
2026.04.29-15:00:35.94 - <debug> [noop] Dumping arguments for Image classification:
2026.04.29-15:00:35.94 - <debug> [noop] model: (null)
2026.04.29-15:00:35.94 - <debug> [noop] len_img: 79281
2026.04.29-15:00:35.94 - <debug> [noop] len_out_text: 256
2026.04.29-15:00:35.94 - <debug> [noop] len_out_imgname: 256
2026.04.29-15:00:35.94 - <debug> [noop] will return a dummy result
2026.04.29-15:00:35.94 - <debug> [noop] will return a dummy result
Output(2):  This is a dummy classification tag!
2026.04.29-15:00:35.94 - <debug> Released session 1

Installing the examples🔗

If you want to install an example for local use, you can use go install. For example:

go install github.com/nubificus/vaccel-go/examples/classify

will install the classify example in your local Go binary path.

Building the examples from source🔗

You can also clone the repository locally to build the examples:

git clone https://github.com/nubificus/vaccel-go.git
cd vaccel-go
make

If all went well, the examples' binaries should be available in ./bin.