ModelForge

A production-ready CLI tool for hardware detection and publishing system specifications.

Features

• Hardware Detection: Automatically detects CPU, RAM, GPU, and OS information
• NVIDIA GPU Support: Detects NVIDIA GPUs and CUDA availability via nvidia-smi
• Capability Detection: Identifies AVX/AVX2/AVX512 CPU capabilities
• Interactive CLI: Clean, colored terminal output with spinners
• API Publishing: Optional publishing to remote API

Installation

npm install -g model-forge

Or run directly with npx:

npx model-forge scan

Usage

Basic Scan

model-forge scan

Output:

✔ Hardware analyzed

CPU: Ryzen 7 5800X (16 cores)
RAM: 32 GB
GPU: RTX 3070 (8 GB VRAM)
OS: Windows

JSON Output

model-forge scan --json

Skip Confirmation

model-forge scan --yes

Silent Mode

model-forge scan --silent

Options

| Flag | Description | |------|-------------| | --json | Output raw JSON only | | --yes | Skip confirmation prompt | | --silent | Minimal output |

Development

# Install dependencies
npm install

# Build
npm run build

# Run locally
node dist/bin.js scan

# Link for global testing
npm link

Release Workflow

# Patch release
npm run release:patch

# Minor release
npm run release:minor

# Major release
npm run release:major

# Custom release (with publish)
node scripts/release.js --minor

# Release without publishing
node scripts/release.js --patch --no-publish

Project Structure

model-forge/
├── bin/               # CLI entry point
├── dist/              # Built output
├── scripts/           # Build & release scripts
├── src/
│   ├── index.js       # CLI commander setup
│   ├── hardware.js    # System information collection
│   ├── normalize.js  # Data normalization
│   ├── display.js    # Terminal output
│   ├── prompt.js     # Interactive prompts
│   └── api.js        # API integration
├── package.json
└── CHANGELOG.md

License

MIT