Skip to main content

Introduction

The Signaloid CLI is a powerful command-line application that lets you interact with the Signaloid Cloud Compute Engine directly from your terminal and from automated scripts.

What is the Signaloid CLI?​

The Signaloid CLI is a unified tool that provides:

  • 🚀 Fast access to Signaloid Cloud Compute Engine features
  • 🔨 Automation for building and running tasks on Signaloid cores
  • 📊 Data visualization for uncertainty quantification
  • 🎨 Web front end generation for your applications

Key Features​

Repository Integration​

Connect your GitHub repositories and build them on Signaloid's specialized cores:

signaloid-cli repos connect --url https://github.com/user/project

Build Management​

Create and get status of the build from source code or repositories:

signaloid-cli builds create:source --file main.c --lang C
signaloid-cli builds status --build-id <id>

Task Execution​

Run tasks on Signaloid C0 cores and retrieve results:

signaloid-cli tasks create --build-id <id> --args "--input data.csv"
signaloid-cli tasks output --task-id <id>

File Operations​

Manage files in your Signaloid storage:

signaloid-cli files upload --path datasets/data.csv --from ./local-data.csv
signaloid-cli files download --path results/output.txt

Visualization​

Plot distributions from Ux strings:

signaloid-cli plot ux-string --ux-string <ux-string> --out distributions/

Quick Example​

Here's a complete workflow from repository to results:

# 1. Authenticate
signaloid-cli auth login --api-key <your-key>

# 2. Connect a repository
signaloid-cli repos connect \
  --url https://github.com/signaloid/Signaloid-Demo-C-Template \
  --branch main \
  --dir src

# 3. Create a build
signaloid-cli builds create:repo --repo-id <repo-id>

# 4. Run a task
signaloid-cli tasks create --build-id <build-id> --args "-A argA -B argB"

# 5. Get the output
signaloid-cli tasks output --task-id <task-id>

Next Steps​

Getting Help​

Last updated on