Skip to main content

Professional Python Cybersecurity CLI Tool (Sentinel AI CLI)

Project description

Sentinel AI CLI

PyPI Python License Open Source

Sentinel AI CLI is a professional, open-source cybersecurity tool for Linux. It provides real-time network monitoring, system information, intelligent connection analysis, and risk classification to help you secure your machine—instantly from your terminal.


Features

  • Network Scanner: List all active network connections with process details
  • System Information: Display OS, kernel, CPU, memory, and hostname
  • Connection Analyzer: Detect and classify suspicious connections with numeric risk scoring (0–100) and risk level (LOW, MEDIUM, HIGH)
  • Report Command: Show summary of total connections, external connections, risk counts, and overall system risk score
  • Explain Command: Explain if an IP/connection is potentially dangerous
  • Debug: Run and debug a Python file, catching exceptions and logging errors
  • Explain Code: Summarize and list functions/classes in a Python file
  • Improve Code: Auto-format a Python file using autopep8 for better readability
  • Colored Output: Professional, readable CLI with colorama
  • Logging: All actions and errors are logged for auditing
  • Production-Ready: Modular, clean, and robust code

Installation

From PyPI (recommended)

pip install sentinel-ai-cli

From source

git clone https://github.com/Bangkah/sentinel.git
cd sentinel
pip install -r requirements.txt

Requirements

  • Python 3.7+
  • psutil
  • colorama
  • autopep8


Usage Examples

  • Scan active network connections:
    sentinel-ai scan
    
  • Show system information:
    sentinel-ai system
    
  • Analyze connections and classify risk:
    sentinel-ai analyze
    
    Example output:
    Proto  Local Address         Remote Address        PID     Process    Risk        Reason
    TCP    192.168.1.10:54321   8.8.8.8:53            1234    python3    HIGH (87)  External IP; Unusual port; Unknown process
    ...
    
  • Show summary report:
    sentinel-ai report
    
    Example output:
    === Sentinel AI CLI Security Report ===
    Total connections: 12
    External connections: 3
    High risk: 1
    Medium risk: 2
    Low risk: 9
    Overall system risk: HIGH (72/100)
    
  • Explain a specific IP address:
    sentinel-ai explain 8.8.8.8
    
  • Debug a Python file:
    sentinel-ai debug path/to/your_script.py
    
  • Explain a Python code file:
    sentinel-ai explain-code path/to/your_script.py
    
  • Improve (auto-format) a Python code file:
    sentinel-ai improve-code path/to/your_script.py
    


Screenshots

Sentinel AI CLI Demo


How GitHub Copilot CLI Helped

GitHub Copilot CLI accelerated the development of Sentinel AI by:

  • Generating modular, production-ready Python code
  • Suggesting robust error handling and logging patterns
  • Providing intelligent CLI argument parsing with argparse
  • Recommending best practices for security and code structure
  • Speeding up the implementation of colored output and risk analysis logic

Thanks to Copilot CLI, Sentinel AI was built faster, with higher code quality and maintainability.


Contributing

Contributions are welcome! Please open issues or pull requests to help improve Sentinel AI.


License

This project is licensed under the MIT License.


Support & Links

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

sentinel_ai_cli-1.0.5.tar.gz (7.7 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

sentinel_ai_cli-1.0.5-py3-none-any.whl (8.0 kB view details)

Uploaded Python 3

File details

Details for the file sentinel_ai_cli-1.0.5.tar.gz.

File metadata

  • Download URL: sentinel_ai_cli-1.0.5.tar.gz
  • Upload date:
  • Size: 7.7 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/6.2.0 CPython/3.14.2

File hashes

Hashes for sentinel_ai_cli-1.0.5.tar.gz
Algorithm Hash digest
SHA256 bf1e37607e034f78edd94ab3f1a7140b89b43e3d58a08371e9d96f8345c6bbd4
MD5 9d4ae9c9652deed3ac97d5142e483f04
BLAKE2b-256 92691626aa681cf150786bcb6ce2b3d2fcdd04c1e87b2b5510f818e0d8c3efcc

See more details on using hashes here.

File details

Details for the file sentinel_ai_cli-1.0.5-py3-none-any.whl.

File metadata

File hashes

Hashes for sentinel_ai_cli-1.0.5-py3-none-any.whl
Algorithm Hash digest
SHA256 58247a5be0e133403f8d338e88ab66087b5f31c446f0108d776e36a3399e03f6
MD5 67a1e77ab76fb7ebbccf8f10d6da93ce
BLAKE2b-256 f81db1ca430e61e0418b54d8f33e9e610ba9234982ff72bcd74b9f3a860465f7

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page