Tutorial: Getting Started with Teknoir

Tutorial: Getting Started with Teknoir

Welcome to Teknoir! This guide will help you get started with our comprehensive MLOps platform. Follow the steps below to set up and begin using Teknoir's powerful features!

 

Introduction to Teknoir

Teknoir is an advanced platform designed for deploying AI at the edge. It includes several components to support your AI and machine learning workflows:

  • ML Laboratory: An interactive environment for data scientists and ML engineers.
  • Marvin: A generative AI assistant for natural language queries.
  • App Store: A marketplace for discovering and distributing AI applications.
  • Teknoir Orchestration Engine & Device OS: An OS for edge devices, supporting real-time control and AI inferencing.
  • The Grid: A low-code graphical environment for developing AI workflows.
  • The Console: A central hub for managing all your hardware and software components.

 

System Requirements

Before you begin, ensure your system meets the following requirements:

  • Operating System: Windows 10 or later, macOS 10.15 or later, Linux (Ubuntu 18.04 or later).
  • Processor: Intel i5 or equivalent.
  • Memory: 8 GB RAM minimum (16 GB recommended).
  • Storage: 50 GB free space.
  • Network: Reliable internet connection for updates and cloud services.

 

Device Configuration and Setup

In this section we will configure your edge device to securely communicate with the Teknoir platform.

 

Visit https://teknoir.cloud and login using your username and password.

On the side-panel menu, select Devices


Click on New Device

Fill in the appropriate fields below and select Add

Name (required)

This will be the name of the device.

Namespace (not editable)

This indicates which namespace the device will belong to. To create a device under another namespace, please select namespace in the top bar prior to creating a new device.

Hardware (optional)

Select type of device or device architecture. Choose generic to skip OS image creation and only rely on the installer.

User (optional)

Modes:

·         Generated user authentication: User name will be teknoir with a generated password.

·         Username and password: You can specify user name and password yourself.

Fields:

·         User Name: This will be the username of the account used to access the device operating system.

·         Password: Set a password for the account. The password needs to be at least 8 characters long, and also contain at least: one uppercase, one lowercase and one number.

·         SSH Authorized Public Key: Copy your own public ssh key here for convenience when connecting to the device on a local network.

Note: The SSH Authorized Public Key will be provisioned to the users authorized_keys. This enables password less ssh login for that user if you have the matching private key.

 

Ethernet (optional)

Note: This is not available for generic hardware option.

Modes:

·         Dynamically assign IP: You acquire IP address automatically with DHCP client.

·         Static IP: You configure a static IP address and subnet mask.

·         Static IP + DHCP Server: You configure a static IP address and subnet mask and start a DHCP server to let peripherals acquire IP addresses on the same subnet.

Fields:

·         IP Address: The static IP address.

·         Subnet: Specify subnet mask in CIDR format.

 

Wifi (optional)

Note: This is not available for generic hardware option.

Modes:

·         No Wifi: Do not configure any Wifi

·         Connect to Wifi: Specify credentials for the Wifi network to connect to.

·         Create Access Point: Create a Wifi with credentials that peripherals can connect to.

Fields:

·         SSID: Enter the name of the network you wish to grant the device access to.

·         Password: Enter the password for the network.

·         Country Code: Enter the country code for the network. A full list of country codes can be found here.

Note: Adding WiFi credentials to the device configuration will allow the device to automatically connect to that nearby WiFi when booting up.

 

Metadata (optional)

Add and remove metadata/labels that later can be used for managing devices at scale and annotate data.

·         Add Label: Use this button to add an additional row of key and value.

·         Key: Enter keyword for the metadata (example: city).

·         Value: Enter value for the corresponding keyword metadata (example: new york).

 

Create a “drop-in” installer script

The installer is created for all types of devices, but if the generic hardware option is chosen it is the only thing to be generated for that device. The process usually takes less than 30 seconds.

  1. Browse to devices.
  2. Choose namespace.
  3. Click the device name.
  4. Scroll down to Resources and wait until the Download and Copy links for the installer become active, this should take no longer than 60 seconds.
Run the installer on the device
  1. When ready, click the Copy device-name’s bootstrap string for the installer link, and the command is copied to your clipboard.
  2. Open a secure shell to your device and paste the content and press enter
  3. Follow the instructions on the screen.
  1. Note: You will be prompted at the end of the installer to add a user, default: teknoir, to your system. Be careful that it does not overwrite an existing user with keys or certificates!
  1. Note: Normally it takes no more than a couple of minutes for the device to connect but depending on the speed of your device, SD-card and internet connection it might take some minutes more.


Congratulations, the device will now attempt to connect to our platform and you will be able to manage it from there!