AI-Native Security Platform with Zero-Trust Architecture and Autonomous Network Management
Sentinel is a comprehensive security platform that combines zero-trust architecture, intelligent network management, and AI-driven automation. It provides real-time network discovery, automatic segmentation, traffic optimization, and self-healing capabilities.
- Zero-Trust Identity (Gatekeeper): Continuous authentication and authorization
- Credential Management (Keymaster): Certificate lifecycle and secrets management
- Network Fabric (NetMesh): Software-defined networking with automatic VLAN management
- Firewall (Shield): L3-L7 inspection with WAF capabilities
- Detection (Observer): SIEM/XDR with event correlation
- AI Agents: Autonomous network management with human-in-the-loop controls
| Agent | Purpose |
|---|---|
| Discovery | Network scanning and device classification |
| Optimizer | Traffic engineering and QoS management |
| Planner | Segmentation and VLAN automation |
| Orchestrator | Workload placement and scaling |
| Forecaster | Predictive analytics and capacity planning |
| Healer | Self-repair and automated failover |
| Guardian | Security policy enforcement |
┌─────────────────────────────────────────────────────────────┐
│ SENTINEL CONTROL PLANE │
├─────────────────────────────────────────────────────────────┤
│ ┌──────────────┐ ┌──────────────┐ ┌──────────────────┐ │
│ │ Gatekeeper │ │ Keymaster │ │ Policy Engine │ │
│ │ (Identity) │ │ (Credentials)│ │ (Zero-Trust) │ │
│ └──────────────┘ └──────────────┘ └──────────────────┘ │
│ │ │
│ ┌──────┴──────┐ │
│ │ AI Agents │ │
│ │ Council │ │
│ └──────┬──────┘ │
│ │ │
│ ┌──────────────┐ ┌──────┴──────┐ ┌──────────────────┐ │
│ │ NetMesh │ │ Shield │ │ Observer │ │
│ │ (Network) │ │ (Firewall) │ │ (SIEM) │ │
│ └──────────────┘ └─────────────┘ └──────────────────┘ │
└─────────────────────────────────────────────────────────────┘
- Python 3.11+
- Docker and Docker Compose (for deployment)
- Network equipment with API access (OPNsense, UniFi, etc.)
- Ollama (for local AI inference)
# Clone the repository
git clone https://github.com/GozerAI/sentinel.git
cd sentinel
# Create virtual environment
python -m venv .venv
source .venv/bin/activate # On Windows: .venv\Scripts\activate# Install dependencies
pip install -e ".[dev]"# Copy and configure settings
cp config/default.yaml config/local.yaml
# Edit config/local.yaml with your settings# Start with local configuration
sentinel --config config/local.yaml
# Or run directly with Python
python -m sentinel.main --config config/local.yaml
# Run with Docker
docker-compose -f deploy/docker/docker-compose.prod.yml up -dSee config/homelab.yaml for a complete configuration example. Key settings:
integrations:
router:
type: "opnsense"host: "192.168.1.1"api_key: "${ROUTER_API_KEY}"switch:
type: "ubiquiti"controller_url: "https://192.168.1.2:8443"llm:
primary:
type: "ollama"host: "http://localhost:11434"model: "llama3.1:8b"sentinel/
├── src/sentinel/
│ ├── core/ # Core engine and models
│ ├── agents/ # AI agents
│ ├── integrations/ # External system integrations
│ ├── api/ # REST API
│ └── cli/ # Command-line interface
├── tests/ # Test suite
├── config/ # Configuration files
├── deploy/ # Deployment configurations
└── docs/ # Documentation
# Install dev dependencies
pip install -e ".[dev]"# Run tests
pytest
# Run tests with coverage
pytest --cov=sentinel --cov-report=html
# Format code
black src tests
# Lint code
ruff check src tests
# Type checking
mypy src- Fork the repository
- Create a feature branch (
git checkout -b feature/amazing-feature) - Commit your changes (
git commit -m 'Add amazing feature') - Push to the branch (
git push origin feature/amazing-feature) - Open a Pull Request
This project is licensed under the MIT License - see the LICENSE file for details.
Documentation: https://sentinel.gozerai.com/docs
Issues: https://github.com/GozerAI/sentinel/issues