🛰️ Sentinel-X

The autonomous multimodal intelligence platform for 3D situational awareness, drone swarm orchestration, and proactive urban defense.

Quickstart · Docs · Architecture · Contributing · Discussions

Sentinel-X is a production-grade, open-source intelligence platform that fuses computer vision, acoustic sensing, satellite imagery, drone telemetry, and NLP into a single autonomous decision engine. It is designed for national security operations, urban safety monitoring, and proactive threat detection.

It runs on your own infrastructure with full data sovereignty — no cloud dependency, no third-party data sharing.

• Self-host on your server — Full control, full privacy
• 3D Digital Twin — Real-time CesiumJS situational awareness
• Autonomous drone response — Detect → Triangulate → Dispatch
• Military-standard symbology — MIL-STD-2525D compliant
• Field sync with ATAK — Push intel to agents' handheld devices
• Every contribution welcome — From typo fixes to new AI modules

You can deploy Sentinel-X on your laptop, a dedicated server, or in the cloud.

Prerequisites: Python 3.11+, pip, MongoDB

git clone https://github.com/Vexel-Innovations/Sentinel-X.git
cd Sentinel-X
pip install -r requirements.txt
uvicorn main:app --host 0.0.0.0 --port 8000

Access the API at http://localhost:8000/docs. Access the Dashboard at http://localhost/frontend/dashboard.php.

Prerequisites: Docker, Docker Compose

git clone https://github.com/Vexel-Innovations/Sentinel-X.git
cd Sentinel-X
docker-compose up -d

This starts both the AI Engine (port 8000) and MongoDB automatically.

docker pull ghcr.io/vexel-innovations/sentinel-x:latest
docker run -p 8000:8000 ghcr.io/vexel-innovations/sentinel-x:latest

Sentinel-X is built as a modular, event-driven system where each intelligence domain operates as an independent service, fused by a central decision engine.

┌─────────────────────────────────────────────────────────────────┐
│                        FRONTEND LAYER                          │
│                  CesiumJS 3D Digital Twin                       │
│              MIL-STD-2525D Tactical Symbology                  │
└────────────────────────┬────────────────────────────────────────┘
                         │ REST API
┌────────────────────────┴────────────────────────────────────────┐
│                      FastAPI GATEWAY                            │
│               /api/v1/vision  /api/v1/drone  /api/v1/iot       │
└───┬────────┬────────┬────────┬────────┬────────┬───────────────┘
    │        │        │        │        │        │
┌───┴──┐ ┌──┴──┐ ┌──┴───┐ ┌──┴──┐ ┌──┴───┐ ┌──┴──┐
│Vision│ │Drone│ │ IoT  │ │ NLP │ │ SAT  │ │ CoT │
│  AI  │ │Swarm│ │Sensor│ │ LLM │ │GeoAI │ │ATAK │
└───┬──┘ └──┬──┘ └──┬───┘ └──┬──┘ └──┬───┘ └──┬──┘
    │        │        │        │        │        │
┌───┴────────┴────────┴────────┴────────┴────────┴───────────────┐
│                     🧠 FUSION ENGINE                            │
│           Anomaly Detection → Threat Assessment →               │
│           Autonomous Response → Ethical Guardrails              │
└────────────────────────┬────────────────────────────────────────┘
                         │
                    ┌────┴────┐
                    │ MongoDB │
                    └─────────┘

Each module can be developed, tested, and deployed independently. The Fusion Engine orchestrates all modules into a unified intelligence pipeline.

• Architecture Overview
• API Reference (after starting the server)
• Deployment Guide
• Contributing Guide
• Security Policy
• Code of Conduct

We welcome contributions of all sizes — from fixing a typo to building a new AI module. No contribution is too small.

See our Contributing Guide for:

• 🟢 Beginner-friendly tasks
• 🟡 Intermediate challenges
• 🔴 Advanced AI/Defense engineering

Every expert was once a beginner. Your journey with Sentinel-X starts now. 🌍

This project is licensed under the Apache License 2.0.