{"id":20447752,"url":"https://github.com/mawg0ud/vulnvortex","last_synced_at":"2025-04-13T01:10:35.769Z","repository":{"id":114987795,"uuid":"555814228","full_name":"mawg0ud/VulnVortex","owner":"mawg0ud","description":"Advanced Network Vulnerability Scanner","archived":false,"fork":false,"pushed_at":"2024-12-08T05:51:45.000Z","size":162,"stargazers_count":24,"open_issues_count":1,"forks_count":4,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-03-26T19:03:07.925Z","etag":null,"topics":["cybersecurity","incident-response","infosec","intrusion-detection","network","network-scanning","penetration-testing","pentesting","risk-management","threat-intelligence"],"latest_commit_sha":null,"homepage":"","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mawg0ud.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2022-10-22T11:49:58.000Z","updated_at":"2025-03-16T10:51:40.000Z","dependencies_parsed_at":null,"dependency_job_id":"45254406-0f5b-47b3-ae7e-72610c1307e1","html_url":"https://github.com/mawg0ud/VulnVortex","commit_stats":null,"previous_names":["mawg0ud/vulnvortex-"],"tags_count":0,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mawg0ud%2FVulnVortex","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mawg0ud%2FVulnVortex/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mawg0ud%2FVulnVortex/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mawg0ud%2FVulnVortex/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mawg0ud","download_url":"https://codeload.github.com/mawg0ud/VulnVortex/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":248650750,"owners_count":21139681,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["cybersecurity","incident-response","infosec","intrusion-detection","network","network-scanning","penetration-testing","pentesting","risk-management","threat-intelligence"],"created_at":"2024-11-15T10:29:21.323Z","updated_at":"2025-04-13T01:10:35.757Z","avatar_url":"https://github.com/mawg0ud.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# VulnVortex - Advanced Network Vulnerability Scanner\n\n![Version](https://img.shields.io/badge/version-1.0-blue.svg) ![License](https://img.shields.io/badge/license-MIT-green) ![Status](https://img.shields.io/badge/status-active-brightgreen)\n\n**VulnVortex** is a network vulnerability scanner designed for in-depth network analysis, exploitation simulation, and vulnerability reporting. It provides an extensible platform suitable for both beginners and advanced users, offering a CLI, GUI, modular plugin support, and automation capabilities.\n\n\nThis tool provides a versatile toolset for proactive network security management, with powerful scanning capabilities and extensibility via plugins. Whether you're a security researcher, IT administrator, or developer, VulnVortex enhances your vulnerability detection and response strategy, tailored to suit both small and large-scale network environments.\n\n## Features\n\n- **Comprehensive Network Scanning**: Configurable IP and port range scanning with detailed vulnerability detection.\n- **Flexible Interfaces**: Use CLI or GUI based on preferences.\n- **Modular Plugin System**: Customize by adding plugins for new vulnerability checks.\n- **Automated Reporting and Alerts**: Create reports and send alerts via email or Slack.\n- **Third-Party Integration**: Easily integrate with external vulnerability databases and APIs.\n\n## Table of Contents\n\n- [Installation](#installation)\n- [Configuration](#configuration)\n- [Usage](#usage)\n  - [CLI Mode](#cli-mode)\n  - [GUI Mode](#gui-mode)\n- [Reports and Alerts](#reports-and-alerts)\n- [Plugin Development](#plugin-development)\n- [Testing and Validation](#testing-and-validation)\n- [Documentation](#documentation)\n- [Contributing](#contributing)\n- [License](#license)\n\n## Installation\n\nTo set up **VulnVortex**, clone the repository and install the required dependencies:\n\n```bash\ngit clone https://github.com/mawg0ud/VulnVortex.git\ncd VulnVortex\npip install -r requirements.txt\n```\n\n## Configuration\n\n### Configuration File (`config/config.yaml`)\n\nVulnVortex uses a configuration file (`config/config.yaml`) for setting network parameters, vulnerability database details, and API keys. **Edit** the YAML file to customize settings such as IP range, scan frequency, reporting formats, and third-party API integrations.\n\n**Sample Configuration:**\n\n```yaml\nnetwork:\n  ip_range: \"192.168.1.0/24\"\n  scan_ports: \"22,80,443\"\nreporting:\n  output_directory: \"reports/\"\n  format: \"html\"\nvulnerability_database:\n  update_frequency: \"weekly\"\n  source_url: \"https://vuln-db.org/api\"\napi_keys:\n  some_service: \"YOUR_API_KEY\"\n```\n\n### Schema Validation\n\nTo ensure that `config.yaml` is correctly structured, validation occurs using `config/schema.yaml`. This provides a reliable way to detect configuration errors and maintain compatibility.\n\n## Usage\n\n**VulnVortex** provides both **CLI** and **GUI** interfaces to allow flexibility in usage.\n\n### CLI Mode\n\nThe CLI interface offers granular control over scanning, reporting, and configuration management. Run a basic scan with the following command:\n\n```bash\npython main.py --mode cli --scan 192.168.1.0/24 --output html\n```\n\n**CLI Options:**\n\n- `--scan`: Specify the IP range to scan.\n- `--output`: Choose output report format (e.g., `html`, `txt`).\n\n### GUI Mode\n\nThe GUI offers an intuitive interface for users preferring graphical controls. Launch with:\n\n```bash\npython main.py --mode gui\n```\n\nThe GUI supports network range input, real-time scan results, and options to save reports.\n\n## Reports and Alerts\n\n### Report Generation\n\nReports are generated in HTML or plain-text formats, summarizing vulnerabilities, affected hosts, and severity. Reports are saved in the `reports/` directory by default.\n```\n\n## Plugin Development\n\nThe `plugins/` directory allows users to extend VulnVortex by creating custom plugins for additional vulnerability checks. Example plugins, such as `sample_plugin.py`, demonstrate the structure and integration process.\n\n**Sample Plugin Structure:**\n\n```python\nclass SamplePlugin:\n    def __init__(self, scanner):\n        self.scanner = scanner\n\n    def run(self):\n        # Plugin logic here\n```\n\n**Creating a New Plugin**: Create a new file in `plugins/`, following the structure of `sample_plugin.py`, and initialize it in the main `Scanner` class to make it operational.\n\n## Testing and Validation\n\nTesting modules are located in `tests/`, containing both unit and integration tests.\n\nTo run all tests:\n\n```bash\npython -m unittest discover tests\n```\n\n**Test Coverage**: Tests cover functionality for configuration loading, scanning logic, reporting, and integration with APIs. We recommend running tests regularly to ensure stability, especially after modifying core modules or adding plugins.\n\n## Documentation\n\n- **User Guide**: [docs/user_guide.md](docs/user_guide.md) - Detailed setup, usage examples, and best practices.\n- **Developer Guide**: [docs/developer_guide.md](docs/developer_guide.md) - Contributing, plugin development, and project structure.\n- **API Reference**: [docs/api_reference.md](docs/api_reference.md) - Complete API documentation for core modules and utilities.\n\n## Contributing\n\nWe welcome contributions to improve VulnVortex. To contribute, please fork the repository, create a branch, and submit a pull request. Make sure to review the **developer documentation** and adhere to coding standards outlined in `docs/developer_guide.md`.\n\n## License\n\nVulnVortex is licensed under the MIT License. See [LICENSE](LICENSE) for more details.\n\n\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmawg0ud%2Fvulnvortex","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmawg0ud%2Fvulnvortex","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmawg0ud%2Fvulnvortex/lists"}