Cloud-X Security is a unified security dashboard designed to bring enterprise-level monitoring, detection, and response capabilities to Small and Medium Businesses (SMBs) at an affordable scale. It combines powerful open-source tools with custom modules into a single pane of glass.
- Unified Dashboard: Real-time overview of your security posture, network health, and active threats.
- Network Scanning: Integrated Nmap/Masscan/Zmap functionality to discover open ports and vulnerabilities (
/api/scans). - Agent Management: Centralized deployment and monitoring of Wazuh agents across Windows, Linux, and macOS.
- Real-time Alerts: Instant notifications for critical security events.
- Modular Architecture: Extensible design support for future modules like NIDS, DLP, and AI Analytics.
- Frontend: Vite + React + TypeScript
- UI Framework: ShadcnUI (TailwindCSS + RadixUI)
- Routing: TanStack Router
- Backend: Flask (Python) with Celery & Redis for async tasks
- Core Engine: Wazuh SIEM (Integration in progress)
Cloud-X-MVP/
├── src/ # Frontend Source Code (React + TypeScript)
│ ├── components/
│ │ ├── ui/ # ShadcnUI base components
│ │ ├── layout/ # Layouts (Sidebar, Header, AppShell)
│ │ └── pages/ # Page-specific components
│ ├── routes/ # TanStack Router file-based routes
│ │ ├── _protected/ # Protected routes (dashboard, apps, etc.)
│ │ └── sign-in.tsx # Authentication routes
│ ├── lib/ # API client and utilities
│ ├── context/ # React Context providers
│ ├── hooks/ # Custom React hooks
│ └── assets/ # Images and static files
├── cloudx-flask-backend/ # Backend API (Flask + Python)
│ ├── app.py # Main Flask application
│ ├── deployer.py # Agent deployment logic (SSH/WinRM)
│ ├── scripts/ # Agent installation scripts
│ │ ├── windows/ # PowerShell modules, certs
│ │ ├── linux/ # Bash scripts, threat removal
│ │ └── mac/ # macOS installation scripts
│ └── scanners/ # Network scanning modules (Nmap, ZMap, Masscan)
├── cloudx-security-agent/ # Agent configuration & documentation
│ ├── documentation/ # Agent integration guides
│ └── wazuh-configs/ # Wazuh agent configurations
└── Documentation/ # Project Documentation
├── INDEX.md # Central documentation index
├── FRONTEND.md # Frontend architecture guide
├── BACKEND_AGENTS.md # Backend & Agent technical docs
├── BACKEND_CONFIG.md # Backend setup and configuration
├── project-description.md # Vision & Roadmap details
└── prohect-wireframe.md # UI Wireframes
- Node.js & npm/pnpm
- Python 3.10+
- Redis server (for backend tasks)
-
Clone the repository
git clone https://github.com/MAPLEIZER/Cloud-X-MVP.git cd Cloud-X-MVP -
Start the Backend
# See Documentation/BACKEND_AGENTS.md for full setup npm run dev:backend -
Start the Frontend
npm run dev
-
Run Both (Recommended)
npm run dev:all
We are actively building the next generation of Cloud-X with focus on:
- NIDS/IDPS: Network Intrusion Detection
- DLP: Data Loss Prevention
- AI Analytics: Automated Threat Hunting
See ROADMAP.md for the detailed development plan.