lab-ia-suite 🚀

A premium, production-ready, zero-dependency Node.js CLI package to bundle and download lab assets (Machine Learning notebooks, SDP Word documents, and Android MAD projects) across Windows, macOS, and Linux.

Features

• ⚡ Zero Dependencies: Installs globally in less than a second! Immunized against package supply-chain attacks and deprecation issues.
• 🔥 Dual Executable Commands: Installs two global terminal commands:
  • lab (extremely short, elegant)
  • lab-ia (fully explicit)
• 📍 Smart Path Resolver: Seamlessly supports and resolves:
  • Windows Desktop paths & backslash mappers
  • Tilde shortcuts (~/Desktop, ~/Downloads)
  • Leading slash shorthands (/Desktop, /Downloads)
  • Local relative paths and system absolute paths
  • Automatically creates missing directories recursively.
• 🛡️ Byte-Safe Binary Operations: Copies raw documents byte-for-byte using stream buffers, preventing UTF text-encoding corruptions on Word files or notebooks.
• 🔍 Real-Time Integrity Scanning:
  • Natively checks .docx files for valid ZIP headers (PK\x03\x04).
  • Parses .ipynb Jupyter Notebooks using secure JSON decoders.
  • Validates row structural lengths in .csv datasets.
• 🔒 Overwrite Safety: Protects files from silent overrides unless explicitly requested via the --force option.

Global Installation

Install directly via npm:

npm install -g lab-ia-suite

CLI Usage Guide

1. Download to Default Downloads Folder

Copies all structured lab assets to ~/Downloads recursively:

lab download-all

Optional: Verbose log printing

lab download-all --verbose

2. Download to a Custom Folder

Downloads all assets directly into a custom target directory. Supports directory shortcuts:

# Supports home tildes:
lab download --dir ~/Desktop/MyLabs --verbose

# Supports leading slashes:
lab-ia download --dir /Desktop/Labs-Test

# Supports relative or absolute paths:
lab download -d ./Labs-Local

3. CLI Option Flags

| Flag | Shorthand | Description | |---|---|---| | --dir <path> | -d | Path to save the lab folders to (required for download). | | --verbose | -v | Show detailed files copy and transfer status logs. | | --force | -f | Bypass file overwrite checks (overwrites existing files). | | --help | -h | Display the CLI commands and helper menu. |

Integrity Validation

Our hidden diagnostic verification command validates package file footprint integrity at any time:

lab validate-assets

License

MIT. Crafted by pair developers.