Skip to content

Necroraijin/Inbriq

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

11 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

🛡️ Inbriq

Intelligent Network Security Platform

Inbriq is a Self-adaptive cybersecurity platform that leverages multi-agent AI technologies to provide real-time threat detection, automated response, and continuous learning capabilities. Built for the modern cybersecurity landscape with quantum-resistant cryptography and federated learning.

🌟 Overview

Inbriq represents the future of network security, combining advanced machine learning algorithms with real-time monitoring to create an intelligent defense system that adapts and evolves with emerging threats.

Key Features

  • 🧠 AI-Powered Threat Detection: Advanced ML models for real-time threat identification
  • 🤖 Multi-Agent Architecture: Specialized AI agents working in coordination
  • 🔒 Quantum-Resistant Security: Future-proof cryptography implementation
  • 📊 Real-time Dashboard: Professional dark-mode interface with 3D visualization
  • 🔄 Adaptive Learning: Continuous improvement through federated learning
  • ⚡ High Performance: Sub-200ms threat detection and response

🏗️ Architecture

System Architecture

🚀 Quick Start

Prerequisites

  • Python 3.8+ (3.9+ recommended)
  • 4GB+ RAM (8GB+ recommended for optimal performance)
  • Modern web browser with WebGL support
  • Network access for real-time monitoring

Installation

Option 1: Direct Installation

# Clone the repository
git clone https://github.com/yourusername/inbriq.git
cd inbriq

# Install dependencies
pip install -r requirements.txt

# Start the platform
python main.py

Option 2: Virtual Environment (Recommended)

🐍 Python Virtual Environment Setup

Windows

# Create virtual environment
python -m venv inbriq-env

# Activate virtual environment
inbriq-env\Scripts\activate

# Upgrade pip
python -m pip install --upgrade pip

# Install dependencies
   pip install -r requirements.txt

# Start Inbriq
python main.py

macOS/Linux

# Create virtual environment
python3 -m venv inbriq-env

# Activate virtual environment
source inbriq-env/bin/activate

# Upgrade pip
python -m pip install --upgrade pip

# Install dependencies
pip install -r requirements.txt

# Start Inbriq
python main.py

Deactivating Virtual Environment

# Windows
deactivate

# macOS/Linux
deactivate

Access Points

Once running, access Inbriq through:

🎯 Demo Scenarios

Threat Detection & Response

  • 🚨 DDoS Attack: Automatic detection and mitigation
  • 🦠 Malware Traffic: Real-time identification and blocking
  • 🔍 Port Scanning: Detection and response to reconnaissance
  • 📤 Data Exfiltration: Monitoring and prevention
  • 🔐 Suspicious Login: Multi-factor authentication triggers

AI Learning & Adaptation

  • 🧠 Behavioral Analysis: Continuous learning of patterns
  • 📊 Trust Scoring: Dynamic risk assessment
  • ⚡ Performance Optimization: Self-tuning parameters
  • 🌐 Federated Learning: Collaborative threat intelligence

🛠️ Technical Stack

Backend Technologies

  • FastAPI: High-performance web framework
  • Python 3.8+: Core programming language
  • Asyncio: Asynchronous programming support
  • WebSockets: Real-time communication

AI/ML Libraries

  • Scikit-learn: Machine learning algorithms
  • NumPy: Numerical computing
  • Pandas: Data manipulation and analysis
  • Joblib: Model persistence

Frontend Technologies

  • HTML5/CSS3: Modern web standards
  • JavaScript: Interactive functionality
  • Three.js: 3D network visualization
  • Bootstrap 5: Responsive UI framework
  • Chart.js: Data visualization

Security Features

  • Quantum-Resistant Cryptography: Future-proof encryption
  • Blockchain Audit Trail: Immutable security logs
  • Zero Trust Architecture: Continuous verification
  • Federated Learning: Privacy-preserving intelligence

📊 Performance Metrics

  • Detection Accuracy: 95%+ for known threats
  • Response Time: <200ms average decision latency
  • False Positive Rate: <2% with continuous learning
  • Throughput: 1000+ packets/second analysis
  • Uptime: 99.9% availability target

🔧 Configuration

Environment Variables

Create a .env file in the project root:

# Server Configuration
HOST=0.0.0.0
PORT=8000
DEBUG=False

# Security Settings
SECRET_KEY=your-secret-key-here
ENCRYPTION_KEY=your-encryption-key-here

# Database (if using external DB)
DATABASE_URL=sqlite:///./inbriq.db

# Logging
LOG_LEVEL=INFO
LOG_FILE=inbriq.log

Customization

Threat Detection Thresholds

# In src/core/threat_detector.py
THREAT_THRESHOLD = 0.5  # Adjust sensitivity
ANOMALY_THRESHOLD = 0.3  # Anomaly detection sensitivity

Performance Tuning

# In src/optimization/performance_engine.py
MAX_CONCURRENT_ANALYSES = 100
CACHE_SIZE = 1000
BATCH_SIZE = 50

🧪 Testing

Run Tests

# Run all tests
python -m pytest tests/

# Run with coverage
python -m pytest --cov=src tests/

# Run specific test file
python -m pytest tests/test_threat_detection.py

Manual Testing

# Test API endpoints
curl http://localhost:8000/api/health
curl http://localhost:8000/api/status

# Test threat simulation
curl -X POST "http://localhost:8000/api/demo/simulate-attack?attack_type=ddos"

🚀 Deployment

Docker Deployment

# Dockerfile
FROM python:3.9-slim

WORKDIR /app
COPY requirements.txt .
RUN pip install -r requirements.txt

COPY . .
EXPOSE 8000

CMD ["python", "main.py"]
# Build and run
docker build -t inbriq .
docker run -p 8000:8000 inbriq

Production Deployment

Using Gunicorn

# Install Gunicorn
pip install gunicorn

# Run with Gunicorn
gunicorn -w 4 -k uvicorn.workers.UvicornWorker main:app --bind 0.0.0.0:8000

Using Nginx (Reverse Proxy)

# /etc/nginx/sites-available/inbriq
server {
    listen 80;
    server_name your-domain.com;

    location / {
        proxy_pass http://127.0.0.1:8000;
        proxy_set_header Host $host;
        proxy_set_header X-Real-IP $remote_addr;
    }
}

📈 Monitoring & Maintenance

Health Checks

# Check system health
curl http://localhost:8000/api/health

# Check performance metrics
curl http://localhost:8000/api/enhanced/performance/metrics

# Check system status
curl http://localhost:8000/api/status

Log Management

# View logs
tail -f inbriq.log

# Rotate logs (Linux/macOS)
logrotate /etc/logrotate.d/inbriq

Backup & Recovery

# Backup configuration
tar -czf inbriq-backup-$(date +%Y%m%d).tar.gz models/ config/

# Restore from backup
tar -xzf inbriq-backup-20240101.tar.gz

Development Setup

# Fork and clone the repository
git clone https://github.com/yourusername/inbriq.git
cd inbriq

# Create development environment
python -m venv dev-env
source dev-env/bin/activate  # Linux/macOS
# or
dev-env\Scripts\activate  # Windows

# Install development dependencies
pip install -r requirements-dev.txt

# Run tests
python -m pytest tests/

# Run linting
flake8 src/
black src/

Code Style

  • Follow PEP 8 guidelines
  • Use type hints where appropriate
  • Write comprehensive tests
  • Document new features

📚 API Documentation

Core Endpoints

Endpoint Method Description
/api/health GET System health check
/api/status GET System status and metrics
/api/dashboard/data GET Dashboard data
/api/threats GET Recent threats
/api/network/stats GET Network statistics

Enhanced Endpoints

Endpoint Method Description
/api/enhanced/trust/scores GET Trust scoring data
/api/enhanced/performance/metrics GET Performance metrics
/api/enhanced/behavioral/profiles GET Behavioral analysis

Advanced Endpoints

Endpoint Method Description
/api/advanced/federated-learning/status GET Federated learning status
/api/advanced/quantum-crypto/status GET Quantum crypto status
/api/advanced/threat-hunting/status GET Threat hunting status

About

Inbriq is a Self-adaptive cybersecurity platform that leverages multi-agent AI technologies to provide real-time threat detection, automated response, and continuous learning capabilities. Built for the modern cybersecurity landscape with quantum-resistant cryptography and federated learning.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors