Skip to main content

sima-cli Command Reference

Generated Markdown reference documentation for the sima-cli command line interface.

Installation​

For most users, install the latest official release from the public installer URL for your operating system.

Linux, macOS, and DevKit​

Run the installer from a terminal:

curl -fsSL https://artifacts.neat.sima.ai/sima-cli/linux-mac.sh | bash

After installation, open a new terminal or reload your shell profile, then verify the install:

sima-cli --version

Windows PowerShell​

Download and run the Windows installer from PowerShell:

Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/windows.bat -OutFile windows.bat
.\windows.bat

After installation, open a new Command Prompt or PowerShell window, then verify the install:

sima-cli --version

Advanced: choose a branch or release​

Use install.py only when you need to choose a specific tested branch build or release instead of installing the latest official PyPI release.

On Linux, macOS, or DevKit:

curl -fsSL https://artifacts.neat.sima.ai/sima-cli/install.py -o sima-cli-install.py
python3 sima-cli-install.py

Install a specific branch or release:

python3 sima-cli-install.py feature/my-branch latest
python3 sima-cli-install.py v2.1.6 latest

On Windows PowerShell:

Invoke-WebRequest https://artifacts.neat.sima.ai/sima-cli/install.py -OutFile sima-cli-install.py
python .\sima-cli-install.py

To install a specific branch or release:

python .\sima-cli-install.py feature/my-branch latest
python .\sima-cli-install.py v2.1.6 latest

Release tags such as v2.1.6 install from public PyPI. Branch names install tested artifacts from artifacts.neat.sima.ai/sima-cli.

Public PyPI releases can also be installed directly:

pip install sima-cli

Guides​

GuideDescription
Boot Image and Netboot OperationsPrepare local or downloaded images, configure remote netboot safely, recover from address changes, and prepare eMMC for flashing with sima-cli bootimg.
SDK Setup and Extension ManagementChoose optional SDK services, browser VS Code extensions, and the Model Compiler installation source when running sima-cli sdk setup.
System Update OperationsUse daily builds, signed eLxr 3.0 SWU bundles, A/B inspection, storage staging, and persistent-overlay handling with sima-cli update.
Neat SDK Networking SetupThe Neat SDK, also known as the Neat Development Environment, runs inside a Docker container. sima-cli sdk setup creates the container, prepares the host workspace mount, starts Insight when enabled, and publishes the container ports that the host browser and a DevKit use during development.
Roll Back SDK Network ChangesUse rollback when you want to inspect or undo Linux host networking changes made by SDK setup or network repair.
Troubleshoot SDK NetworkingUse the network doctor when the SDK container, Insight UI, DevKit SSH, RTSP, WebRTC video, or workspace sync does not behave as expected.

Top-Level Commands​

CommandDescription
sima-cli appzooAccess sample apps from the App Zoo.
sima-cli bootimgPrepare a bootable image for the SiMa DevKit.
sima-cli deviceDiscover nearby SiMa.ai devices on the local network.
sima-cli downloadDownload a file or a whole folder from a given URL.
sima-cli installInstall SiMa packages.
sima-cli loginAuthenticate with the SiMa Developer Portal.
sima-cli logoutLog out by deleting cached credentials and config files.
sima-cli mlaMachine Learning Accelerator Utilities.
sima-cli modelzooAccess models from the Model Zoo.
sima-cli neatDiscover, download, and install Neat build artifacts.
sima-cli networkSetup Network IP address on the DevKit
sima-cli nvmePerform NVMe operations on the Modalix DevKit.
sima-cli packagesManage sima-cli package registry (list, inspect, clean, etc.)
sima-cli playbooksInstall and manage playbooks (Codex/Claude).
sima-cli sdcardPrepare the SD Card as a data storage device for MLSoc DevKit or Modalix Early Access Unit
sima-cli sdkManage and launch SiMa SDK 2.0 container environments (Beta).
sima-cli selfupdateUpdate sima-cli manually from PyPI or a direct wheel URL.
sima-cli serialConnect to the UART serial console of the DevKit.
sima-cli updateUpdate a SiMa DevKit, remote device, or Linux PCIe host.

Complete Command List​