DOCUMENTATION

Guide to setting up the Chooch Inference Engine

Chooch Inference Engine Setup Guide

Within the dashboard, this guide will walk you through the steps to set up an edge device running Chooch models for CPU, NVDIA GPU, and Jetson Orin. The guide will explain how to use the Chooch AI Vision Studio to create a device, add camera streams, and add AI models to the device. Finally, you will follow steps to install the Chooch Inference Engine on your device to see the AI in action.

Please note you will need a free account on the Chooch AI Vision Studio. If you don’t yet have one, please sign up here. For the moment, you will also need an Enterprise account. Please email: [email protected].

Hardware Requirements

GPU (8.0.0)

Compatible Graphics Card Platforms: T4, V100, L40, A2, A10, A30, A100, RTX Ampere (Ax000/RTX30x0)
Compatible Operating Systems: Ubuntu ≥ 20.04
GCC: GCC 9.4.0
CUDA Release: CUDA ≥ 11.7.1
cuDNN Release: cuDNN 8.4.1.50+
TRT Release: TRT 8.4.1.5
Display Driver: ≥ R515.65.01
Compatible Processors
- 8th to 13th generation Intel® Core™ > i7 (suggested i9)
- 3rd generation Intel® Xeon® Scalable processors
Memory: Min 32GB RAM
Disk: 256GB SSD Drive

CPU (8.0.0)

Compatible Processors
- 8th to 13th generation Intel® Core™ > i7 (suggested i9)
- 3rd generation Intel® Xeon® Scalable processors
Compatible Operating Systems: Ubuntu* 18.04.3 LTS and above (64 bit)
Memory: Min 32GB RAM
Disk: 256GB SSD Drive

Jetson Orin (8.0.0)

Compatible Processors	Jetson AGX Orin 64GB Jetson AGX Orin 32 GB
Compatible Operating Systems	Jetpack 5.1.2
Memory	Min 32GB RAM

Installation Guide

Notes:

An Internet connection is needed to perform many of the following steps.
Many of the following command lines will require your system’s root or super user password

GPU (8.0.0) Setup Guide

Installation requirements for Ubuntu server for GPU

If Ubuntu has not been installed, please use the following link: https://releases.ubuntu.com/20.04/.

If Ubuntu has been previously installed, please skip to the next step.

Enter the following script to your terminal and follow the instructions.

This installation time may take approximately 60 minutes or more, based on your network upload speed.


														
														#default GPU install (see below for other optional arguments)
#NOTE: API key MUST go after -k argument. Other optional argument appends to the end.

bash -c "$(curl http://get.chooch.ai/inference-engine-v8)" -s -k api_key

#NOTE: This command installs the necessary driver version and Nvidia Docker, deletes the oldest inference engine, and installs a new Chooch Inference Engine.

Optional arguments

api_key
API Key provided by Chooch can be found at the bottom of your Chooch AI Vision Studio Homepage.

CPU (8.0.0) Setup Guide

Installation requirements for Ubuntu Server for CPU

Please follow the docker installation instructions:
https://docs.docker.com/engine/install/ubuntu/

Enter the following script to your terminal and follow the instructions:

This installation time may take approximately 60 minutes or more, based on your network upload speed.


														
														#default CPU install (see below for other optional arguments)
#NOTE: api key MUST go after -k argument. Other optional argument append to the end

bash -c "$(curl http://get.chooch.ai/inference-engine-v8-cpu)" -s -k api_key

Optional arguments

-d <install_dir>
install directory (defaults to $HOME if not specified)

api_key
API Key provided by Chooch can be found at the bottom of your dashboard’s Homepage.

Jetson Orin (8.0.0) Setup Guide

Chooch supports the NVIDIA JetPack SDK. JetPack installation is managed by NVIDIA SDK Manager. You will need to create a free NVIDIA account or use an existing one.

Please follow the NVIDIA SDK Manager installation instructions that explain how to install Jetpack OS 5.1.2, using a host device (host device requirements below).

Required Host Operating System	Ubuntu ≥ 20.04
Compatible Jetpack Version	Jetpack 5.1.2
Required Host Hardware	RAM 8GB Internet Connection

All CUDA libraries will be included in Jetpack. If you are seeing errors about missing CUDA drivers, please reboot to confirm proper installation and setup.

Jetson Orin Installation Guide

On Host Device:
- Connect the hardware directly to the host device with SDK Manager installed. (This will vary from device to device, but normally a USB cord is provided)
- Launch NVIDIA SDK Manager, make the following selections:
  - Select the connected device
  - Select JetPack 5.1.2
  - Follow the on-screen prompts until the device begins to install the required configurations.
Once the JetPack 5.1.2 is installed, navigate to the Jetson-Orin Edge Hardware:
- Open CLI Terminal
- Run the following command


														
														# Replace API_KEY with your API Key generated from app.chooch.ai dashboard.

bash -c "$(curl http://get.chooch.ai/inference-engine-v8-jetson)" -k API_KEY

If you are accessing the Jetson Orin device locally, login into http://localhost:3000 and follow the instructions below. If accessing Jetson Orin remotely, login from the Jetson’s public IP address at port 3000 to access the Chooch Inference Engine.

Chooch Inference Engine Setup

Log in to your Chooch AI Vision Studio account.
Go to Devices
Create a device
Add a stream to your device
Add Models to your stream
You can access your Chooch Inference Engine interface on your device from http://localhost:3000/.
Copy and paste the Device ID of the device you want to connect. The Device list can be found under the Devices tab of your dashboard.
Set a password to access the dashboard.
You can access your Chooch Inference Engine interface on the device after installation, from http://localhost:3000/.
Once you have finalized changes to your stream from https://app.chooch.ai dashboard, click on Cloud Sync from the Inference Engine dashboard to sync the changes.
- Note: If Cloud Sync doesn’t appear to finish, try refreshing the page.
Verify camera feed is showing and sending prediction data by clicking on Streams tab.
Now you can start using the system!

Some useful commands start, stop and restart the service on device.

Start the Chooch Inference Engine


														
														docker-compose start

Stop the Chooch Inference Engine


														
														docker-compose stop

Restart the Chooch Inference Engine


														
														docker-compose restart

Support

For technical support, contact [email protected].