You're Invited:Meet the Socket Team at BlackHat and DEF CON in Las Vegas, Aug 4-6.RSVP
Socket
Book a DemoInstallSign in
Socket

scematics-cli

Package Overview
Dependencies
Maintainers
1
Alerts
File Explorer

Advanced tools

Socket logo

Install Socket

Detect and block malicious and high-risk dependencies

Install

scematics-cli

A CLI tool for managing file uploads

0.1.22
pipPyPI
Maintainers
1

ScematicsCLI

A command-line interface (CLI) tool for accessing and managing Scematics API resources. This tool provides an interactive way to work with Scematics projects, uploads, annotations, and more.

Installation

pip install scematics-cli

Upgrading

To upgrade to the latest version:

pip install --upgrade scematics-cli

To completely reinstall the package:

pip uninstall scematics-cli -y
pip install scematics-cli

Features

  • User Authentication: Login with credentials or API key
  • Project Management: List and view project details
  • Data Upload Options:
    • Direct upload for images and videos
    • Folder-wise project upload
    • Tag-based upload
    • Custom video folder upload
  • Annotation Management:
    • Export annotations with progress tracking
    • Import annotations from files
  • Interactive Interface: User-friendly CLI with menus

Requirements

  • Python 3.10
  • Internet connection for API access
  • Scematics account credentials or API key

Usage

After installation, you can launch the tool with:

scematics-cli

Authentication

When you start the application, you'll be prompted to choose your authentication method:

Please choose your authentication method.
Choose option (1: Login with credentials, 2: Use API key) [1/2] (1):
  • Option 1: Enter your username and password
  • Option 2: Provide your API key

Available Commands

Once authenticated, you'll see the main menu with these options:

#Command
1List All Projects
2Get Project Details
3Upload Images (Local to App)
4Export Annotations
5Import Annotations
6Upload Media (Local/Cloud to App)
7Logout
qQuit

1. List All Projects

Displays all your projects with basic information including:

  • Project Name
  • Project ID
  • Description
  • Progress percentage
  • Total Images
  • Completed Images

2. Get Project Details

Retrieves and displays detailed information about a specific project:

+----------------------------------------+
| Project Details                        |
+----------------------------------------+
| Project Name      | exampleprojects    |
| Project ID        | exampleprojects097 |
| Description       | Annotations        |
| Progress          | 75%                |
| Total Images      | 1330               |
| Completed Images  | 1000               |
+----------------------------------------+

3. Upload Images (Local to App)

Opens the upload submenu with multiple upload options:

#Option
1Upload Images (Single/Multiple)
2Upload Image Folder (Project-wise)
3Upload with Tags (Local Images)
bBack to Main Menu

3.1 Upload Images (Single/Multiple)

Uploads files directly to an existing project.

Required input:

  • Project ID
  • Path to files

Example folder structure:

/home/user/images/
├── image1.jpg
├── image2.png
├── image3.jpeg
└── image4.tiff

3.2 Upload Image Folder (Project-wise)

Creates new projects based on folder names and uploads images from those folders.

Required input:

  • Path to main folder containing subfolders

Example folder structure:

/home/user/main-folder/
├── folder1/
│   ├── image1.jpg
│   ├── image2.png
│   ├── image3.jpeg
│   ├── image4.bmp
│   ├── photo1.tiff
│   └── sample_image.gif
├── folder2/
│   ├── image1.jpg
│   ├── image2.png
│   ├── image3.jpeg
│   ├── image4.bmp
│   ├── photo1.tiff
│   └── sample_image.gif
└── folder3/
    ├── image1.jpg
    ├── image2.png
    ├── image3.jpeg
    ├── image4.bmp
    ├── photo1.tiff
    └── sample_image.gif

In this case, three projects will be created named "folder1", "folder2", and "folder3", each containing its respective images.

3.3 Upload with Tags (Local Images)

Uploads files using folder names as tags.

Required input:

  • Project ID
  • Path to main folder containing subfolders

Example folder structure: Same as folder-wise upload, but folder names are used as tags for the images instead of project names.

4. Export Annotations

Exports annotations from a project.

Required input:

  • Project name
  • Export format

5. Import Annotations

Imports annotations into a project.

Required input:

  • Project name
  • Import format
  • File path

6. Upload Media (Local/Cloud to App)

Uploads both images and videos from either your local system or supported cloud storage (S3, GCP, Azure).

Sub-options:

#Option
1Upload Folder (Images/Videos from Local)
2Quick Upload (Local to App)
3Upload from Cloud Storage (S3, GCP, Azure)
bBack to Main Menu

6.1 Upload Folder (Local)

Uploads a structured folder of images or videos from your machine.

6.2 Quick Upload (Local)

For uploading one-off files quickly without complex folder structure.

6.3 Upload from Cloud Storage

Uploads data from supported cloud storage (like S3, GCP, Azure) using your access credentials.

Example folder structure:

Main Folder (e.g., test)
├── [UUID-subfolder1]
│   ├── examplenames.mp4
│   └── examplenames.json
├── [UUID-subfolder2]
│   ├── examplenames.mp4
│   └── examplenames.json
└── ...

7. Logout

Logs out the current user session.

Examples

Login Example

Please choose your authentication method.
Choose option (1: Login with credentials, 2: Use API key) [1/2] (1):
Username: user@example.com
Password: ********
Login successful!
Starting application...

Project Upload Example

After selecting "Folder-wise Project Upload", provide the main folder path:

Enter the path to the main folder: /home/user/main-folder/

The system will:

  • Create projects named after each subfolder
  • Upload images from each subfolder to their respective projects
  • Display progress during the upload

Supported File Formats

Images

  • jpg/jpeg
  • png
  • bmp
  • tiff/tif
  • gif

Videos

  • mp4

Troubleshooting

If you encounter any issues:

  • Check your internet connection
  • Verify your credentials
  • Ensure you have the correct permissions for the project
  • Check if the file path exists and is accessible
  • If the upload process is interrupted for any reason (such as internet disconnection or system error), a _thumbnail folder might still be created at your specified path. In such cases, please delete the existing _thumbnail folder before attempting the upload again. A fresh folder will be automatically generated during the next upload.
  • If you face an error during upload, please ensure that each image within a dataset has a unique filename. Each image must have a unique name. Rename the image and try again.

Contact

For support, please contact info@scematics.io

FAQs

Did you know?

Socket

Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.

Install

Related posts

SocketSocket SOC 2 Logo

Product

About

Packages

Stay in touch

Get open source security insights delivered straight into your inbox.

  • Terms
  • Privacy
  • Security

Made with ⚡️ by Socket Inc

U.S. Patent No. 12,346,443 & 12,314,394. Other pending.