{"id":21191749,"url":"https://github.com/edgeimpulse/linux-sdk-go","last_synced_at":"2025-07-10T03:31:04.406Z","repository":{"id":51354347,"uuid":"356249419","full_name":"edgeimpulse/linux-sdk-go","owner":"edgeimpulse","description":"Use Edge Impulse for Linux models from Go","archived":false,"fork":false,"pushed_at":"2021-05-13T18:39:53.000Z","size":39,"stargazers_count":4,"open_issues_count":1,"forks_count":2,"subscribers_count":16,"default_branch":"master","last_synced_at":"2024-06-19T11:29:41.218Z","etag":null,"topics":[],"latest_commit_sha":null,"homepage":null,"language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"apache-2.0","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/edgeimpulse.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null}},"created_at":"2021-04-09T11:40:31.000Z","updated_at":"2024-06-19T11:29:41.219Z","dependencies_parsed_at":"2022-09-26T21:41:02.074Z","dependency_job_id":null,"html_url":"https://github.com/edgeimpulse/linux-sdk-go","commit_stats":null,"previous_names":[],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgeimpulse%2Flinux-sdk-go","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgeimpulse%2Flinux-sdk-go/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgeimpulse%2Flinux-sdk-go/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/edgeimpulse%2Flinux-sdk-go/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/edgeimpulse","download_url":"https://codeload.github.com/edgeimpulse/linux-sdk-go/tar.gz/refs/heads/master","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":225615187,"owners_count":17496945,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":[],"created_at":"2024-11-20T19:04:46.744Z","updated_at":"2024-11-20T19:04:47.512Z","avatar_url":"https://github.com/edgeimpulse.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Edge Impulse Linux SDK for Go\n\nThis library lets you run machine learning models and collect sensor data on Linux machines using Go. This SDK is part of [Edge Impulse](https://www.edgeimpulse.com) where we enable developers to create the next generation of intelligent device solutions with embedded machine learning. [Start here to learn more and train your first model](https://docs.edgeimpulse.com).\n\n## Installation guide\n\n1. Install [Go 1.15](https://golang.org/dl/) or higher.\n1. Clone this repository:\n\n    ```\n    $ git clone https://github.com/edgeimpulse/linux-sdk-go\n    ```\n\n1. Find the example that you want to build and run `go build`:\n\n    ```\n    $ cd cmd/eimclassify\n    $ go build\n    ```\n\n1. Run the example:\n\n    ```\n    $ ./eimclassify\n    ```\n\n    And follow instructions.\n\n1. This SDK is also published to pkg.go.dev, so you can pull the package from there too.\n\n## Collecting data\n\nBefore you can classify data you'll first need to collect it. If you want to collect data from the camera or microphone on your system you can use the Edge Impulse CLI, and if you want to collect data from different sensors (like accelerometers or proprietary control systems) you can do so in a few lines of code.\n\n### Collecting data from the camera or microphone\n\nTo collect data from the camera or microphone, follow the [getting started guide](https://docs.edgeimpulse.com/docs/edge-impulse-for-linux) for your development board.\n\n### Collecting data from other sensors\n\nTo collect data from other sensors you'll need to write some code to collect the data from an external sensor, wrap it in the Edge Impulse Data Acquisition format, and upload the data to the Ingestion service. [Here's an end-to-end example](https://github.com/edgeimpulse/linux-sdk-go/blob/master/cmd/eimcollect/main.go).\n\n## Classifying data\n\nTo classify data (whether this is from the camera, the microphone, or a custom sensor) you'll need a model file. This model file contains all signal processing code, classical ML algorithms and neural networks - and typically contains hardware optimizations to run as fast as possible. To grab a model file:\n\n1. Train your model in Edge Impulse.\n1. [Install the Edge Impulse for Linux CLI](https://docs.edgeimpulse.com/docs/edge-impulse-for-linux).\n1. Download the model file via:\n\n    ```\n    $ edge-impulse-linux-runner --download modelfile.eim\n    ```\n\n    This downloads the file into `modelfile.eim`. (Want to switch projects? Add `--clean`)\n\nThen you can start classifying realtime sensor data. We have examples for:\n\n* [Audio](https://github.com/edgeimpulse/linux-sdk-go/blob/master/cmd/eimaudio/main.go) - grabs data from the microphone and classifies it in realtime.\n* [Camera](https://github.com/edgeimpulse/linux-sdk-go/blob/master/cmd/eimimage/main.go) - grabs data from a webcam and classifies it in realtime.\n* [Custom data](https://github.com/edgeimpulse/linux-sdk-go/blob/master/cmd/eimclassify/main.go) - classifies custom sensor data.\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedgeimpulse%2Flinux-sdk-go","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fedgeimpulse%2Flinux-sdk-go","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fedgeimpulse%2Flinux-sdk-go/lists"}