{"id":48289785,"url":"https://github.com/yashab-cyber/nmap-ai","last_synced_at":"2026-04-04T23:02:35.643Z","repository":{"id":305733470,"uuid":"1023644874","full_name":"yashab-cyber/nmap-ai","owner":"yashab-cyber","description":" NMAP-AI: AI-Powered Network Scanning \u0026 Automation  Platform      🤖 Revolutionizing network scanning with AI-powered automation, intelligent script generation, and advanced port scanning capabilities","archived":false,"fork":false,"pushed_at":"2025-08-09T17:35:53.000Z","size":216,"stargazers_count":10,"open_issues_count":0,"forks_count":5,"subscribers_count":0,"default_branch":"main","last_synced_at":"2025-08-09T19:25:26.597Z","etag":null,"topics":["cybersecurity","ethicalhacking","hacking","kalilinux","nmap"],"latest_commit_sha":null,"homepage":"https://zehrasec.com","language":"Python","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"other","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/yashab-cyber.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":"SECURITY.md","support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null,"zenodo":null}},"created_at":"2025-07-21T13:25:03.000Z","updated_at":"2025-08-09T17:35:56.000Z","dependencies_parsed_at":"2025-07-21T19:43:03.000Z","dependency_job_id":null,"html_url":"https://github.com/yashab-cyber/nmap-ai","commit_stats":null,"previous_names":["yashab-cyber/nmap-ai"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/yashab-cyber/nmap-ai","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fnmap-ai","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fnmap-ai/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fnmap-ai/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fnmap-ai/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/yashab-cyber","download_url":"https://codeload.github.com/yashab-cyber/nmap-ai/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/yashab-cyber%2Fnmap-ai/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":286080680,"owners_count":31418287,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2026-04-04T20:09:54.854Z","status":"ssl_error","status_checked_at":"2026-04-04T20:09:44.350Z","response_time":60,"last_error":"SSL_read: unexpected eof while reading","robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":false,"can_crawl_api":true,"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","ethicalhacking","hacking","kalilinux","nmap"],"created_at":"2026-04-04T23:02:09.603Z","updated_at":"2026-04-04T23:02:35.631Z","avatar_url":"https://github.com/yashab-cyber.png","language":"Python","funding_links":[],"categories":[],"sub_categories":[],"readme":"# 🚀 NMAP-AI: AI-Powered Network Scanning \u0026 Automation\n\n\u003cdiv align=\"center\"\u003e\n  \u003cimg src=\"assets/nmap-ai.png\" alt=\"NMAP-AI Logo\" width=\"200\" height=\"200\"\u003e\n\u003c/div\u003e\n\n![Version](https://img.shields.io/badge/version-1.0.0-blue.svg)\n![Python](https://img.shields.io/badge/python-3.8%2B-blue.svg)\n![License](https://img.shields.io/badge/license-MIT-green.svg)\n![Platform](https://img.shields.io/badge/platform-Linux%20%7C%20Windows%20%7C%20macOS-lightgrey.svg)\n\n\u003e **🤖 Revolutionizing network scanning with AI-powered automation, intelligent script generation, and advanced port scanning capabilities**\n\n## 📋 Table of Contents\n\n- [🌟 Features](#-features)\n- [🚀 Installation](#-installation)\n- [💻 Usage](#-usage)\n- [🤖 AI Capabilities](#-ai-capabilities)\n- [📱 GUI Mode](#-gui-mode)\n- [⌨️ CLI Mode](#-cli-mode)\n- [🛠️ Configuration](#-configuration)\n- [🤝 Contributing](#-contributing)\n- [💰 Support](#-support)\n- [📄 License](#-license)\n\n## 🌟 Features\n\n### 🤖 AI-Powered Capabilities\n- **Intelligent Script Generation**: AI creates custom Nmap scripts based on target analysis\n- **Smart Port Scanning**: ML-optimized scanning strategies for maximum efficiency\n- **Automated Vulnerability Detection**: AI-driven identification of potential security issues\n- **Adaptive Scanning**: Dynamic adjustment of scan parameters based on target responses\n- **Threat Intelligence Integration**: Real-time threat data incorporation\n\n### 🖥️ User Interfaces\n- **Modern GUI**: Cross-platform desktop application with real-time visualization\n- **Advanced CLI**: Powerful command-line interface with scripting support\n- **Web Dashboard**: Browser-based interface for remote management\n- **API Access**: RESTful API for integration with other tools\n\n### 🔧 Advanced Scanning Features\n- **Multi-threaded Scanning**: Parallel execution for faster results\n- **Custom Script Library**: Extensive collection of specialized Nmap scripts\n- **Network Visualization**: Interactive network topology mapping\n- **Report Generation**: Comprehensive reports in multiple formats (PDF, HTML, JSON, XML)\n- **Scheduled Scanning**: Automated recurring scans with alerting\n\n### 🛡️ Security \u0026 Privacy\n- **Offline AI Models**: No data sent to external services\n- **Encrypted Storage**: Secure storage of scan results and configurations\n- **Audit Logging**: Complete logging of all activities\n- **Role-based Access**: Multi-user support with permission controls\n\n## 🚀 Installation\n\n### Prerequisites\n- Python 3.8+\n- Nmap 7.0+\n- Git\n- 4GB RAM minimum (8GB recommended for AI features)\n\n### Quick Installation\n\n```bash\n# Clone the repository\ngit clone https://github.com/yashab-cyber/nmap-ai.git\ncd nmap-ai\n\n# Install dependencies\npip install -r requirements.txt\n\n# Install Nmap (if not already installed)\nsudo apt-get install nmap  # Ubuntu/Debian\nsudo yum install nmap      # CentOS/RHEL\nbrew install nmap          # macOS\n\n# Initialize AI models\npython -m nmap_ai.setup --init-ai\n\n# Run the application\npython -m nmap_ai\n```\n\n### Docker Installation\n\n\u003e **Note**: The Docker image is currently being set up on Docker Hub. Until it's available, you can build the image locally using the instructions below.\n\n**Option 1: Pull from Docker Hub (Coming Soon)**\n```bash\ndocker pull yashabalam/nmap-ai:latest\ndocker run -it --rm yashabalam/nmap-ai:latest\n```\n\n**Option 2: Build Locally (Current Recommended Method)**\n```bash\n# Clone the repository\ngit clone https://github.com/yashab-cyber/nmap-ai.git\ncd nmap-ai\n\n# Build and run using Docker Compose\ndocker-compose up nmap-ai\n\n# Or build manually\n./scripts/docker_build.sh build-prod\ndocker run -it --rm -p 8080:8080 yashabalam/nmap-ai:latest\n```\n\n**Option 3: Using Docker with Volume Mounts**\n```bash\n# For persistent data\ndocker run -it --rm \\\n  -p 8080:8080 \\\n  -v $(pwd)/data:/app/data \\\n  -v $(pwd)/results:/app/results \\\n  yashabalam/nmap-ai:latest\n```\n\n## 💻 Usage\n\n### 🖥️ GUI Mode\n\n```bash\n# Launch GUI application\npython -m nmap_ai --gui\n\n# Or use the desktop shortcut after installation\nnmap-ai-gui\n```\n\n### ⌨️ CLI Mode\n\n```bash\n# Basic AI-powered scan\nnmap-ai --target 192.168.1.0/24 --ai-mode smart\n\n# Generate custom script with AI\nnmap-ai --generate-script --target example.com --vulnerability web\n\n# Advanced port scan with ML optimization\nnmap-ai --target 10.0.0.1 --ports all --ai-optimize --output report.json\n\n# Batch scanning with AI analysis\nnmap-ai --batch targets.txt --ai-analysis --format pdf\n```\n\n### 🌐 Web Dashboard\n\n```bash\n# Start web server\nnmap-ai --web --port 8080\n\n# Access dashboard at http://localhost:8080\n```\n\n## 🤖 AI Capabilities\n\n### 🧠 Intelligent Script Generation\n\nNMAP-AI can automatically generate custom Nmap scripts based on your requirements:\n\n```python\nfrom nmap_ai import AIScriptGenerator\n\ngenerator = AIScriptGenerator()\n\n# Generate script for web application testing\nscript = generator.create_script(\n    target_type=\"web_server\",\n    vulnerabilities=[\"sql_injection\", \"xss\", \"directory_traversal\"],\n    stealth_level=\"high\"\n)\n\n# Generate script for network device scanning\nnetwork_script = generator.create_script(\n    target_type=\"network_device\",\n    device_types=[\"router\", \"switch\", \"firewall\"],\n    protocols=[\"snmp\", \"ssh\", \"telnet\"]\n)\n```\n\n### 🔍 Smart Scanning Algorithms\n\n```python\nfrom nmap_ai import SmartScanner\n\nscanner = SmartScanner()\n\n# AI-optimized port scanning\nresults = scanner.smart_scan(\n    target=\"192.168.1.0/24\",\n    optimization_level=\"aggressive\",\n    ai_model=\"fast_scan_v2\"\n)\n\n# Adaptive scanning with learning\nadaptive_results = scanner.adaptive_scan(\n    target=\"example.com\",\n    learn_from_previous=True,\n    adjust_timing=True\n)\n```\n\n## 📱 GUI Features\n\n### Main Dashboard\n- Real-time scan progress visualization\n- Interactive network topology maps\n- Live port status indicators\n- Threat level heat maps\n\n### AI Assistant Panel\n- Natural language query interface\n- Automated script suggestions\n- Vulnerability explanation and remediation advice\n- Scan optimization recommendations\n\n### Report Generator\n- Customizable report templates\n- Executive summary generation\n- Technical details with screenshots\n- Export options (PDF, HTML, DOCX)\n\n## ⌨️ CLI Advanced Usage\n\n### Scripting and Automation\n\n```bash\n# Create scanning profiles\nnmap-ai --create-profile web_scan --ports 80,443,8080,8443 --scripts http-*\n\n# Use custom AI models\nnmap-ai --ai-model custom_model.pkl --target 10.0.0.0/8\n\n# Integration with other tools\nnmap-ai --target-from-file ips.txt --output-format json | jq '.vulnerabilities'\n\n# Scheduled scanning\nnmap-ai --schedule \"0 2 * * *\" --profile daily_scan --notify email\n```\n\n### Advanced Configuration\n\n```yaml\n# config.yml\nai:\n  models:\n    script_generation: models/script_gen_v3.pkl\n    vulnerability_detection: models/vuln_detect_v2.pkl\n    port_prediction: models/port_pred_v1.pkl\n  \nscanning:\n  default_timeout: 300\n  max_parallel_hosts: 50\n  retries: 3\n  \noutput:\n  default_format: json\n  include_raw_nmap: true\n  compress_results: true\n\nnotifications:\n  email:\n    enabled: true\n    smtp_server: smtp.gmail.com\n    port: 587\n  webhook:\n    enabled: false\n    url: https://your-webhook-url.com\n```\n\n## 🛠️ Plugin System\n\nNMAP-AI supports a flexible plugin architecture:\n\n```python\n# plugins/custom_scanner.py\nfrom nmap_ai.plugins import BasePlugin\n\nclass CustomVulnScanner(BasePlugin):\n    name = \"Custom Vulnerability Scanner\"\n    version = \"1.0.0\"\n    \n    def scan(self, target, options):\n        # Custom scanning logic\n        return results\n    \n    def generate_script(self, requirements):\n        # Custom script generation\n        return script_code\n```\n\n## 🔧 API Reference\n\n### REST API Endpoints\n\n```python\n# Start scan\nPOST /api/v1/scan\n{\n    \"target\": \"192.168.1.0/24\",\n    \"options\": {\n        \"ai_mode\": true,\n        \"stealth\": \"medium\",\n        \"ports\": \"common\"\n    }\n}\n\n# Get scan results\nGET /api/v1/scan/{scan_id}\n\n# Generate AI script\nPOST /api/v1/ai/generate-script\n{\n    \"target_type\": \"web_server\",\n    \"requirements\": [\"vulnerability_scan\", \"service_detection\"]\n}\n\n# List AI models\nGET /api/v1/ai/models\n```\n\n## 🎯 Use Cases\n\n### 🏢 Enterprise Security\n- **Automated Asset Discovery**: AI-powered identification of network assets\n- **Compliance Scanning**: Automated checks for security compliance\n- **Threat Hunting**: Proactive identification of potential threats\n- **Vulnerability Management**: Continuous vulnerability assessment\n\n### 🎓 Education \u0026 Research\n- **Security Training**: Interactive learning environment\n- **Research Projects**: Advanced scanning capabilities for academic research\n- **Penetration Testing**: Professional-grade testing tools\n- **Network Analysis**: Deep network behavior analysis\n\n### 🔒 Penetration Testing\n- **Reconnaissance Automation**: AI-assisted information gathering\n- **Custom Exploit Development**: Script generation for specific targets\n- **Stealth Scanning**: Advanced evasion techniques\n- **Report Generation**: Professional penetration testing reports\n\n## 🚀 Roadmap\n\n### Version 1.1 (Q3 2025)\n- [ ] Enhanced AI models for better accuracy\n- [ ] Mobile companion app (Android/iOS)\n- [ ] Cloud-based scanning coordination\n- [ ] Advanced machine learning analytics\n\n### Version 1.2 (Q4 2025)\n- [ ] Integration with major SIEM platforms\n- [ ] Real-time threat intelligence feeds\n- [ ] Advanced network visualization\n- [ ] Multi-language support\n\n### Version 2.0 (Q1 2026)\n- [ ] Distributed scanning architecture\n- [ ] Advanced AI-powered exploit generation\n- [ ] Blockchain-based result verification\n- [ ] Quantum-resistant scanning protocols\n\n## 🤝 Contributing\n\nWe welcome contributions from the community! Please see our [Contributing Guide](CONTRIBUTING.md) for details.\n\n### Development Setup\n\n```bash\n# Clone repository\ngit clone https://github.com/yashab-cyber/nmap-ai.git\ncd nmap-ai\n\n# Create virtual environment\npython -m venv venv\nsource venv/bin/activate  # Linux/macOS\nvenv\\Scripts\\activate     # Windows\n\n# Install development dependencies\npip install -r requirements-dev.txt\n\n# Install pre-commit hooks\npre-commit install\n\n# Run tests\npython -m pytest\n```\n\n## 💰 Support\n\nIf you find NMAP-AI useful, please consider supporting our development:\n\n- 💰 [Donate via Cryptocurrency or PayPal](DONATE.md)\n- ⭐ Star this repository on GitHub\n- 📢 Share the project with others\n- 🐛 Report bugs and suggest features\n- 📝 Contribute to documentation\n\n## 📜 License\n\nThis project is licensed under the MIT License - see the [LICENSE](LICENSE) file for details.\n\n## 🙏 Acknowledgments\n\n- The Nmap Development Team for creating the amazing Nmap tool\n- The open-source AI/ML community for inspiration and tools\n- All contributors and supporters of the NMAP-AI project\n- ZehraSec for providing development resources and support\n\n## 📞 Contact\n\n- **Email**: yashabalam707@gmail.com\n- **GitHub**: [@yashab-cyber](https://github.com/yashab-cyber)\n- **LinkedIn**: [Yashab Alam](https://www.linkedin.com/in/yashab-alam)\n- **Company**: [ZehraSec](https://www.zehrasec.com)\n- **WhatsApp**: [Business Channel](https://whatsapp.com/channel/0029Vaoa1GfKLaHlL0Kc8k1q)\n\n---\n\n**🚀 Made with ❤️ by Yashab Alam (Founder of ZehraSec) and the NMAP-AI team**\n\n*Revolutionizing network security, one scan at a time.*\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fnmap-ai","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fyashab-cyber%2Fnmap-ai","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fyashab-cyber%2Fnmap-ai/lists"}