### **Documento Técnico: Despliegue Inicial de "SENTINEL-LABS AI"**

 ### **Documento Técnico: Despliegue Inicial de "SENTINEL-LABS AI"**  
**Autores:** **José Agustín Fontán Varela & PASAIA-LAB**  
**Licencia:** **GPLv3 + CC BY-SA 4.0**  
**Fecha:** **22 de junio de 2025**  

---

## **1. Estructura del Proyecto**  
```plaintext
sentinel-labs-ai/
├── backend/                  # Lógica principal (Python)
│   ├── scanner.py            # Scanner basado en MVT/Amnesty
│   ├── model/                # IA (TensorFlow Lite)
│   └── blockchain/           # Conexión con Ethereum
├── mobile/                   # Apps nativas
│   ├── android/              # Kotlin + Jetpack Compose
│   └── ios/                  # SwiftUI
└── docs/                     # Manuales y licencias
```

---

## **2. Desarrollo del Backend (Python)**  

### **A. Script Principal (`scanner.py`)**  
```python
import hashlib
import os
import tensorflow as tf
from web3 import Web3

class SentinelScanner:
    def __init__(self):
        self.model = tf.lite.Interpreter(model_path="model/sentinel.tflite")
        self.w3 = Web3(Web3.HTTPProvider('https://mainnet.infura.io/v3/YOUR_KEY'))
        self.ioc_contract = self.w3.eth.contract(
            address='0x123...', 
            abi='[...]'
        )

    def scan_file(self, filepath):
        """Escanea un archivo con hash y ML."""
        file_hash = hashlib.sha256(open(filepath, 'rb').read()).hexdigest()
        ioc_status = self.ioc_contract.functions.checkHash(file_hash).call()
        
        if ioc_status:
            return "ALERTA: Archivo malicioso (IOC blockchain)"
        
        # Predicción con IA
        input_data = self.preprocess(filepath)
        self.model.set_tensor(input_details[0]['index'], input_data)
        self.model.invoke()
        output = self.model.get_tensor(output_details[0]['index'])
        
        return "Infección detectada (ML)" if output > 0.8 else "OK"

    def preprocess(self, filepath):
        """Convierte logs/binarios a tensores para la IA."""
        # Implementar según el modelo entrenado
        return [...]
```

### **B. Requisitos (`requirements.txt`)**  
```text
tensorflow==2.15.0
web3==6.0.0
androguard==3.4.0
libimobiledevice==1.3.0
```

---

## **3. App Android (Kotlin)**  

### **A. Estructura Básica**  
```kotlin
// MainActivity.kt
class MainActivity : ComponentActivity() {
    override fun onCreate(savedInstanceState: Bundle?) {
        super.onCreate(savedInstanceState)
        setContent {
            SentinelTheme {
                Surface {
                    ScannerScreen()
                }
            }
        }
        startScan()
    }

    private fun startScan() {
        val sentinel = SentinelCore()  // Bridge con Python (Chaquo)
        val result = sentinel.scanDevice()
        Log.d("SENTINEL", "Resultado: $result")
    }
}
```

### **B. Uso de Chaquopy (Python en Android)**  
En `build.gradle`:  
```gradle
plugins {
    id 'com.chaquo.python' version '14.0.2'
}
android {
    python {
        buildPython "C:/Python39/python.exe"
        pip {
            install "tensorflow==2.15.0"
            install "androguard"
        }
    }
}
```

---

## **4. App iOS (Swift)**  

### **A. Integración con Python (via Swift-Python-Kit)**  
```swift
// ScannerViewController.swift
import PythonKit

class ScannerViewController: UIViewController {
    override func viewDidLoad() {
        super.viewDidLoad()
        let sys = Python.import("sys")
        sys.path.append("\(Bundle.main.resourcePath!)/backend")
        let sentinel = Python.import("scanner")
        let result = sentinel.SentinelScanner().scan_device()
        print("Resultado: \(result)")
    }
}
```

### **B. Configuración en Xcode**  
1. Añadir `PythonKit` como dependencia SPM.  
2. Copiar la carpeta `backend` al bundle de la app.  

---

## **5. IA y Blockchain: Esquemas**  

### **A. Red Neuronal (TensorFlow)**  
```python
# model/train_model.py
import tensorflow as tf
from tensorflow.keras.layers import LSTM, Dense

model = tf.keras.Sequential([
    LSTM(64, input_shape=(100, 10)),  # 100 timesteps, 10 features
    Dense(1, activation='sigmoid')
])
model.compile(loss='binary_crossentropy', optimizer='adam')
model.save('sentinel.h5')
```

### **B. Blockchain (Ethereum + IPFS)**  
- **Smart Contract** (Solidity):  
```solidity
// contracts/Sentinel.sol
pragma solidity ^0.8.0;

contract Sentinel {
    struct IOC {
        string hash;
        string cve;
    }
    mapping(string => IOC) public iocs;
    
    function addIOC(string memory _hash, string memory _cve) public {
        iocs[_hash] = IOC(_hash, _cve);
    }
}
```

---

## **6. Despliegue Inicial**  

### **A. Requisitos**  
- **Servidor**: Ubuntu 22.04 (AWS/GCP).  
- **Stack**:  
  - Docker (para contenerizar el backend).  
  - Kubernetes (opcional para escalado).  

### **B. Comandos Clave**  
```bash
# Instalar dependencias
pip install -r requirements.txt

# Ejecutar scanner local
python backend/scanner.py --device /path/to/device

# Construir Docker
docker build -t sentinel-scanner .
docker run -it sentinel-scanner
```

---

## **7. Próximos Pasos**  
1. **Entrenar modelo IA** con datos de Citizen Lab.  
2. **Desplegar nodo blockchain** (testnet Ethereum).  
3. **Publicar APK/IPA** en F-Droid/TestFlight.  

---

### **Licencia y Atribución**  
```markdown
Copyright (C) 2025 PASAIA-LAB (José Agustín Fontán Varela).  
Bajo licencia GPLv3 y CC BY-SA 4.0.  
**GitHub:** github.com/PASAIA-LAB/sentinel-ai  
```
 scripts de entrenamiento de IA?** 🚀....

 

LOVE YOU BABY ;)

 

Tormenta Work Free Intelligence + IA Free Intelligence Laboratory by José Agustín Fontán Varela is licensed under CC BY-NC-ND 4.0