Professional Python Cybersecurity CLI Tool (Sentinel AI CLI)
Project description
Sentinel AI CLI
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 analyzeExample 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 reportExample 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
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
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
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
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
bf1e37607e034f78edd94ab3f1a7140b89b43e3d58a08371e9d96f8345c6bbd4
|
|
| MD5 |
9d4ae9c9652deed3ac97d5142e483f04
|
|
| BLAKE2b-256 |
92691626aa681cf150786bcb6ce2b3d2fcdd04c1e87b2b5510f818e0d8c3efcc
|
File details
Details for the file sentinel_ai_cli-1.0.5-py3-none-any.whl.
File metadata
- Download URL: sentinel_ai_cli-1.0.5-py3-none-any.whl
- Upload date:
- Size: 8.0 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.14.2
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
58247a5be0e133403f8d338e88ab66087b5f31c446f0108d776e36a3399e03f6
|
|
| MD5 |
67a1e77ab76fb7ebbccf8f10d6da93ce
|
|
| BLAKE2b-256 |
f81db1ca430e61e0418b54d8f33e9e610ba9234982ff72bcd74b9f3a860465f7
|