C-MDaaS CLI

Cloud Malware Detection as a Service - Command Line Interface

A powerful CLI tool for detecting malware in Windows PE files using machine learning.

🚀 Installation

Prerequisites

• Node.js 18+ (Download)
• Python 3.8+ with pefile installed
• C-MDaaS Backend running on http://localhost:8000

Install Globally

npm install -g

Or use locally:

npm install
npm start

Or link for development:

npm link
cmdaas

📖 Usage

Start the CLI

cmdaas

Login

• Username: mohammed
• Password: password123

Main Commands

| Command | Description | |---------|-------------| | 🔍 Detect Malware | Scan a PE file for malware | | 📊 View Statistics | See your scan history | | ❓ Help | Show help information | | → Logout | End your session |

Example: Scan a file

1. Select "🔍 Detect Malware"
2. Enter file path: C:\Windows\System32\notepad.exe
3. Press ENTER
4. View results with confidence scores

🔧 Configuration

The CLI connects to:

• API URL: https://cmdaas-backend.onrender.com (Default) or CMDAAS_API_URL env var
• Session file: ~/.cmdaas/session.json

🐛 Troubleshooting

"Classification failed: 401"

Solution: Your session expired. Logout and login again.

"Command failed: py ..."

Solution:

• Make sure Python is installed: py --version
• Install pefile: pip install pefile

"Failed to parse features"

Solution: Make sure you're scanning a valid Windows PE file (.exe, .dll)

Backend not responding

Solution: Start the backend server:

uvicorn backend.api.main:app --reload

📦 Project Structure

cli/
├── index.js              # Main application
├── package.json          # Dependencies
├── backend/
│   └── feature_extractor.py  # PE feature extraction
└── README.md             # This file

🛠️ Development

Run locally

node index.js

Install dependencies

npm install

Test Python extractor

py backend/feature_extractor.py C:\path\to\file.exe

📄 License

MIT License - See main project LICENSE file

🙏 Credits

Built with:

• Ink - React for CLIs
• Chalk - Terminal colors
• Figlet - ASCII art
• pefile - PE parsing

Made with ❤️ for C-MDaaS