PySysTools
🧠 Overview
PySysTools es una suite de herramientas de administración de sistemas y operaciones de seguridad orientada a entornos empresariales. Está construida en Python como una librería instalable con CLI, y está diseñada para ingenieros de sistemas, administradores de infraestructura y profesionales de DevSecOps.
El proyecto cubre cuatro dominios operativos principales: monitoreo del sistema, análisis de redes, operaciones de seguridad y gestión de datos. Cada dominio está encapsulado en su propio módulo dentro del paquete sysadmin_utils, permitiendo un uso modular tanto desde la línea de comandos como mediante integración programática en otros proyectos Python.
Este proyecto sigue un enfoque de Security by Design: las herramientas de análisis y escaneo han sido diseñadas para uso defensivo y auditivo en infraestructuras propias o con autorización explícita.
⚠️ Uso Responsable: Este proyecto tiene fines educativos y éticos de ciberseguridad únicamente. Las capacidades de análisis de seguridad incluidas en esta suite (escaneo de malware, análisis de hash, monitoreo de red) deben utilizarse únicamente en sistemas bajo propiedad o con autorización escrita del propietario. El autor no asume responsabilidad por usos no autorizados o ilegales de estas herramientas.
⚙️ Features
- Generación de contraseñas seguras con longitud y complejidad configurables
- Escaneo de malware en directorios locales mediante análisis de firmas y hashes
- Monitoreo de red en tiempo real con detección de interfaces y tráfico activo
- Supervisión de recursos del sistema (CPU, RAM, disco, procesos) vía
psutil
- Integración con protocolo SMB/CIFS para operaciones sobre recursos compartidos de red
- Automatización de interfaz gráfica para tareas repetitivas en entornos de escritorio
- Gestión de datos con MySQL para almacenamiento y consulta de registros operativos
- Procesamiento y análisis de datos estructurados con
pandas
- Notificaciones nativas en Windows mediante
winotify para alertas del sistema
- CLI unificada que centraliza todos los módulos bajo un único punto de entrada
- Arquitectura modular que permite usar cada componente de forma independiente
🛠️ Tech Stack
| Categoría |
Tecnología |
Uso |
| Lenguaje |
Python 3.8+ |
Core del proyecto |
| Sistema |
psutil |
Monitoreo de procesos y recursos |
| Datos |
pandas |
Análisis y procesamiento de datos |
| Base de datos |
MySQL + mysql-connector-python |
Persistencia de registros |
| Red |
pysmb |
Operaciones SMB/CIFS |
| Automatización |
pyautogui |
Automatización de GUI |
| Notificaciones |
winotify |
Alertas nativas Windows |
| Calidad de código |
flake8 |
Linting y estilo |
| Seguridad estática |
bandit |
Análisis SAST |
| Testing |
pytest |
Pruebas unitarias e integración |
| Empaquetado |
setuptools |
Instalación como paquete Python |
| Diagramas |
Mermaid |
Documentación de arquitectura |
📦 Installation
Requisitos previos
- Python 3.8 o superior
- pip
- MySQL Server (opcional, para módulos de datos)
- Windows 10+ (para notificaciones nativas) o Linux
Instalación desde el repositorio
# 1. Clonar el repositorio
git clone https://github.com/devsebastian44/PySysTools.git
cd PySysTools
# 2. Crear entorno virtual (recomendado)
python -m venv .venv
# Windows
.venv\Scripts\activate
# Linux / macOS
source .venv/bin/activate
# 3. Instalar dependencias
pip install -r requirements.txt
# 4. Instalar el paquete en modo editable
pip install -e .
Verificar la instalación
▶️ Usage
PySysTools expone una CLI principal a través del comando sysadmin_utils. A continuación se muestran los comandos disponibles por módulo:
🔐 Seguridad
# Generar una contraseña segura de 20 caracteres
sysadmin_utils gen-pass -l 20
# Escanear un directorio en busca de archivos maliciosos
sysadmin_utils scan-malware "C:/Users/usuario/Downloads"
🌐 Red
# Iniciar monitoreo de red en tiempo real
sysadmin_utils net-monitor
🖥️ Sistema
# Ver estado general de recursos del sistema
sysadmin_utils sys-status
Uso como librería en Python
from sysadmin_utils.security import generate_password
from sysadmin_utils.network import monitor_network
from sysadmin_utils.system import get_system_info
# Generar contraseña
password = generate_password(length=20)
# Obtener info del sistema
info = get_system_info()
print(info)
🧪 Ejecución de Tests
PySysTools usa pytest para la suite de pruebas funcionales, configuradas para ejecutarse sin endpoints externos y sin necesidad de credenciales reales.
# Ejecutar todas las pruebas
pytest tests/
# Ejecutar con reporte de cobertura
pytest tests/ --cov=src
📁 Project Structure
PySysTools/
│
├── data/ # Muestras de datos CSV para pruebas y demos
│
├── diagrams/ # Diagramas de arquitectura en formato Mermaid
│
├── docs/ # Documentación técnica extendida del proyecto
│
├── examples/ # Scripts de ejemplo para integración de la librería
│
├── src/
│ └── sysadmin_utils/ # Paquete principal instalable
│ ├── data/ # Módulo de conexión y operaciones con MySQL/pandas
│ ├── network/ # Módulo de monitoreo y análisis de red (SMB, interfaces)
│ ├── security/ # Módulo de seguridad: generador de passwords, scanner
│ ├── system/ # Módulo de monitoreo del sistema vía psutil
│ ├── ui/ # Componentes de interfaz de usuario / notificaciones
│ └── utils/ # Funciones auxiliares y helpers compartidos
│
├── .flake8 # Configuración del linter flake8
├── .gitignore # Archivos excluidos del control de versiones
├── LICENSE # Licencia MIT
├── requirements.txt # Dependencias del proyecto
└── setup.py # Configuración de empaquetado con setuptools
Nota: El directorio tests/ contiene la suite completa de pruebas unitarias e integración para validar el correcto funcionamiento de los módulos.
🔐 Security
PySysTools incorpora consideraciones de seguridad en múltiples niveles:
Análisis estático de código: El proyecto utiliza bandit como herramienta de SAST (Static Application Security Testing) en el pipeline CI/CD para detectar patrones de código inseguros antes de cada merge.
Módulo de seguridad defensiva: Las herramientas incluidas (escaneo de malware, análisis de hash) están orientadas a la detección y auditoría, no a la ejecución de código malicioso. Todo escaneo opera sobre rutas locales autorizadas.
Gestión de credenciales: No se almacenan credenciales en el código fuente. Las configuraciones sensibles deben gestionarse mediante variables de entorno o archivos de configuración externos excluidos del repositorio (.gitignore configurado).
Principio de menor privilegio: Se recomienda ejecutar la herramienta con los permisos mínimos necesarios para cada tarea específica.
Contexto ético de uso: Esta suite está diseñada para administración legítima de infraestructura propia. Cualquier uso sobre sistemas de terceros sin autorización escrita constituye una violación ética y potencialmente legal.
🚀 Roadmap
- Soporte multiplataforma completo para Linux/macOS (módulos de notificaciones)
- Integración con APIs de VirusTotal para análisis de hashes en la nube
- Módulo de gestión de logs con parsing automatizado de formatos comunes
- Dashboard web ligero con Flask para visualización de métricas del sistema
- Soporte para exportación de reportes en PDF y JSON
- Integración con SIEM mediante syslog o webhooks
- Autenticación y roles para entornos multiusuario
- Publicación del paquete en PyPI
- Cobertura de tests al 80%+ documentada en pipeline
- Soporte para Docker y despliegue containerizado
🤝 Contributing
¡Las contribuciones son bienvenidas para hacer de PySysTools una herramienta más robusta!
- Haz un Fork del proyecto.
- Crea tu rama para la nueva funcionalidad (
git checkout -b feature/AmazingFeature).
- Ejecuta los tests localmente para asegurar que nada se rompe (
pytest tests/).
- Realiza tus cambios y haz commit usando Conventional Commits (
git commit -m 'feat: add some AmazingFeature').
- Sube tu rama (
git push origin feature/AmazingFeature).
- Abre un Pull Request y nuestro CI (GitHub Actions) validará tu código.
📄 License
Este proyecto está licenciado bajo la MIT License.
Consulta el archivo LICENSE para más detalles.
👨💻 Author
Sebastian Zhunaula
Desarrollador de software con enfoque en automatización de sistemas, seguridad defensiva y herramientas DevSecOps. Apasionado por la construcción de utilidades robustas para administración de infraestructura empresarial.
Built with 🛠️ by Sebastian Zhunaula · MIT License · 2026