# System Monitor A Python-based system security monitoring tool that tracks CPU usage, processes, and network connections. ## Features - Real-time CPU usage monitoring - New process detection - Network connection tracking - Cross-platform support (with enhanced features on Windows) - Detailed logging ## Installation ```bash python -m pip install . ``` For development installation: ```bash python -m pip install -e .[dev] ``` ## Usage ```python from system_monitor import SecurityMonitor monitor = SecurityMonitor() monitor.monitor_system() ``` Or use the command-line script: ```bash system-monitor ``` ## Development 1. Create and activate virtual environment: ```powershell python -m venv .venv .\.venv\Scripts\Activate.ps1 ``` 2. Install development dependencies: ```bash python -m pip install -e .[dev] ``` 3. Run tests: ```bash pytest ``` 4. Format code: ```bash black . isort . ``` ## Requirements - Python 3.8+ - psutil - wmi (Windows only) - tomli (for reading pyproject.toml) ## Documentation - [API Documentation](API.md) - REST API endpoints and usage - [Plugin Development Guide](PLUGIN_DEVELOPMENT.md) - How to create plugins - [Unicode Characters Guide](UNICODE_CHARACTERS.md) - Unicode usage and tools - [Security Policy](SECURITY.md) - Security reporting and policies ## Tools The `tools/` directory contains utilities for repository management: - **find_unicode.py** - Find and analyze Unicode characters in files - **test_unicode_support.py** - Test Unicode rendering in your environment - **unicode_to_ascii.py** - Convert files to ASCII-only versions See [tools/README.md](tools/README.md) for detailed usage. ## License MIT