https://github.com/milosgajdos/ncs
Movidius Neural Compute Stick V2.0 API Go bindings
https://github.com/milosgajdos/ncs
deep-learning edge-computing go golang inference-engine movidius neural-networks usb
Last synced: 28 days ago
JSON representation
Movidius Neural Compute Stick V2.0 API Go bindings
- Host: GitHub
- URL: https://github.com/milosgajdos/ncs
- Owner: milosgajdos
- License: apache-2.0
- Created: 2018-06-27T17:59:34.000Z (almost 7 years ago)
- Default Branch: master
- Last Pushed: 2020-02-25T21:07:48.000Z (about 5 years ago)
- Last Synced: 2025-04-06T10:02:45.359Z (about 2 months ago)
- Topics: deep-learning, edge-computing, go, golang, inference-engine, movidius, neural-networks, usb
- Language: Go
- Homepage:
- Size: 20.2 MB
- Stars: 18
- Watchers: 3
- Forks: 3
- Open Issues: 1
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# ncs
[](https://godoc.org/github.com/milosgajdos/ncs)
[](https://opensource.org/licenses/Apache-2.0)
Neural Compute Stick V2.0 API Go binding
**NCSDK API V2 IS PARTIALLY BROKEN on macOS AT THE MOMENT -- EVERYTHING WORKS FINE ON LINUX**
The code in this repository has been tested on the following Linux OS:
```
Distributor ID: Ubuntu
Description: Ubuntu 16.04.5 LTS
Release: 16.04
Codename: xenial
Linux ubuntu-xenial 4.4.0-134-generic #160-Ubuntu SMP Wed Aug 15 14:58:00 UTC 2018 x86_64 x86_64 x86_64 GNU/Linux
```
The Movidius NCSDK API coverage provided in this repo should give you all the tools to use Movidius NCS to perform Neural Network inference.
# Quick start
On MacOS, clone `macos-V2` branch:
```shell
$ git clone -b macos-V2 https://github.com/milosgajdos/ncsdk.git
```
Build ncsdk API libraries:
```shell
$ cd api/src && sudo make basicinstall pythoninstall
```
Test NCSDK example:
```shell
$ cd ../../examples/apps/hello_ncs_cpp/ && make run
```
# Example Go program
The example below shows how to create and destroy the basic resource types the NCSDK API 2.0 provides. For more complex examples please see [examples](./examples)
```go
package main
import (
"log"
"github.com/milosgajdos/ncs"
)
func main() {
var err error
defer func() {
if err != nil {
log.Fatalf("Error: %s", err)
}
}()
log.Printf("Attempting to create NCS device handle")
dev, e := ncs.NewDevice(0)
if e != nil {
err = e
return
}
defer dev.Destroy()
log.Printf("NCS device handle successfully created")
log.Printf("Attempting to open NCS device")
err = dev.Open()
if err != nil {
return
}
defer dev.Close()
log.Printf("NCS device successfully opened")
log.Printf("Attempting to create NCS graph handle")
graph, e := ncs.NewGraph("NCSGraph")
if e != nil {
err = e
return
}
defer graph.Destroy()
log.Printf("NCS graph handle successfully created")
log.Printf("Attempting to create NCS FIFO handle")
fifo, e := ncs.NewFifo("TestFIFO", ncs.FifoHostRO)
defer fifo.Destroy()
if e != nil {
err = e
return
}
log.Printf("NCS FIFO handle successfully created")
}
```
If your Movidius NCS device is plugged in you should see the following output when running the program above:
```console
2018/08/27 00:43:00 Attempting to create NCS device handle
2018/08/27 00:43:00 NCS device handle successfully created
2018/08/27 00:43:00 Attempting to open NCS device
2018/08/27 00:43:03 NCS device successfully opened
2018/08/27 00:43:03 Attempting to create NCS graph handle
2018/08/27 00:43:03 NCS graph handle successfully created
2018/08/27 00:43:03 Attempting to create NCS FIFO handle
2018/08/27 00:43:03 NCS FIFO handle successfully created
```