QuoreMind / README.md
jako6mina's picture
update readme
39a4414 verified
---
license: apache-2.0
datasets:
- HuggingFaceFW/finetranslations
language:
- en
- es
metrics:
- accuracy
base_model:
- nvidia/personaplex-7b-v1
new_version: nvidia/personaplex-7b-v1
library_name: adapter-transformers
tags:
- code
- chemistry
---
<img width="1024" height="172" alt="retouch_2025111217390816" src="https://github.com/user-attachments/assets/62278260-84c7-4e9d-843d-1014484c471d" />
<div align="center">
⚛️ QuoreMind v1.0.0
----
<h1>Sistema Metripléctico Cuántico-Bayesiano</h1>
![Software](https://img.shields.io/badge/Hybrid-QuoreMind%201.0-white)
![Python](https://img.shields.io/badge/Python-3.9%2B-blue)
![TensorFlow](https://img.shields.io/badge/TensorFlow-2.x-orange)
![License](https://img.shields.io/badge/License-Apache%202.0-green)
![Software](https://img.shields.io/badge/Quantum-AI%20SmokApp-black)
</div>
----
## 🧭 Visión General
**QuoreMind** es un framework analítico de vanguardia diseñado para modelar y predecir la evolución de sistemas cuánticos abiertos mediante la integración de:
- 🔷 **Dinámica Metripléctica** (reversible + disipativa)
- 🔴 **Lógica Bayesiana Cuántica**
- 🟢 **Ruido Probabilístico de Referencia (PRN)**
-**Entropía de von Neumann**
- 🔵 **Corchetes de Poisson**
### Aplicaciones Clave
**Detección forense de anomalías** en información cuántica
**Mitigación de ataques HN/DL** (Harvest Now, Decrypt Later)
**Modulación de fase cuasiperiódica** para criptografía dinámica
**Análisis de decoherencia cuántica** y entrelazamiento
**Optimización de estados cuánticos** resistentes a ruido
---
## ✨ Características Clave
### 🔷 Estructura Nativamente Cuántica
| Característica | Descripción | Impacto en Seguridad |
|---|---|---|
| **Operador Áureo** `Ô_n` | Modula fase cuasiperiódica y paridad del sistema | Ancla estados a secuencia no trivial → Cifrado dinámico robusto |
| **Entropía von Neumann** `S(ρ)` | Métrica fundamental para medir desorden y entrelazamiento | Base para cuantificar decoherencia esperada vs. anómala |
| **Distancia Mahalanobis Cuántica** `D_M` | Desviación estructural respecto a PRN esperado | D_M alta → Indicador potencial de intrusión |
### 🔶 Arquitectura Metripléctica
Fusiona reversibilidad y disipación (análogo a Ecuación de Lindblad):
```
df/dt = {f, H} + [f, S]_M
Parte reversible: {f, H} (Corchetes de Poisson)
Parte disipativa: [f, S]_M (Matriz métrica M)
```
| Componente | Función |
|---|---|
| **Corchetes de Poisson** | Dinámica reversible (Hamiltoniana) |
| **Matriz Métrica M** | Modela disipación e irreversibilidad |
### 🔴 Lógica Bayesiana y PRN
- **PRN**: Modela ruido ambiental estocástico esperado
- **Inferencia Bayesiana**: Calcula probabilidad posterior para decisiones binarias óptimas
- **Coherencia Dinámica**: Parámetro adaptativo basado en estado del sistema
---
## 🏗️ Arquitectura del Proyecto
### Estructura de Clases
```
VonNeumannEntropy
├─ compute_von_neumann_entropy() [Cálculo cuántico]
├─ density_matrix_from_state() [Construcción ρ]
└─ mixed_state_entropy() [Mezclas estadísticas]
PoissonBrackets
├─ poisson_bracket() [Estructura simpléctica]
└─ liouville_evolution() [Ecuación de Liouville]
MetriplecticStructure
├─ metriplectic_bracket() [Corchete metriplexico]
└─ metriplectic_evolution() [Evolución híbrida]
BayesLogic
├─ calculate_posterior_probability() [Teorema de Bayes]
├─ calculate_joint_probability() [Probabilidades conjuntas]
└─ calculate_probabilities_and_select_action() [Decisión final]
QuantumBayesMahalanobis (extends BayesLogic)
├─ compute_quantum_mahalanobis() [Distancia vectorizada]
├─ quantum_cosine_projection() [Proyecciones coseno]
└─ predict_quantum_state() [Predicción de estado]
PRN / EnhancedPRN
├─ adjust_influence() [Modulación de ruido]
├─ combine_with() [Combinación de PRN]
└─ record_quantum_noise() [Registro de anomalías]
QuantumNoiseCollapse (core)
├─ simulate_wave_collapse_metriplectic() [Simulación principal]
├─ objective_function_with_noise() [Función objetivo]
└─ optimize_quantum_state() [Optimización Adam]
```
---
## 🚀 Instalación y Requerimientos
### Requisitos Previos
- **Python 3.9+**
- **pip** o **conda**
### Instalación
```bash
# Clonar repositorio
git clone https://github.com/tlacaelel666/QuoreMind-Metiplectic.git
cd quoremind
# Instalar dependencias
pip install numpy tensorflow tensorflow-probability scikit-learn scipy
# (Opcional) Crear entorno virtual
python -m venv venv
source venv/bin/activate # En Windows: venv\Scripts\activate
```
### Dependencias
```python
numpy >= 1.21.0
tensorflow >= 2.10.0
tensorflow-probability >= 0.19.0
scikit-learn >= 1.0.0
scipy >= 1.7.0
```
---
## 📖 Uso Básico
### Ejemplo 1: Cálculo de Entropía von Neumann
```python
from quoremind import VonNeumannEntropy
import numpy as np
# Crear estado puro de Bell
state = np.array([1/np.sqrt(2), 1/np.sqrt(2)])
density_matrix = VonNeumannEntropy.density_matrix_from_state(state)
# Calcular entropía (normalizada a [0, 1])
entropy = VonNeumannEntropy.compute_von_neumann_entropy(
density_matrix,
state # sigmoid, tanh, log_compression, min_max, clamp
)
print(f"Entropía von Neumann: {entropy:.6f}") # Debe oscilar ∈ [0, 1]
```
### Ejemplo 2: Análisis de Corchetes de Poisson
```python
from quoremind import PoissonBrackets
import numpy as np
# Definir Hamiltoniano
H = lambda q, p: 0.5 * p**2 + 0.5 * q**2 # Oscilador armónico
# Definir observable
x = lambda q, p: q
# Calcular corchete de Poisson
q_val = np.array([1.0])
p_val = np.array([1.0])
bracket = PoissonBrackets.poisson_bracket(x, H, q_val, p_val)
print(f"{{x, H}} = {bracket:.6f}") # Debe ≈ p = 1.0
# Evolución de Liouville: dx/dt = {x, H}
df_dt = PoissonBrackets.liouville_evolution(H, x, q_val, p_val)
print(f"dx/dt = {df_dt:.6f}")
```
### Ejemplo 3: Simulación de Colapso Metripléctico (Uso Completo)
```python
from quoremind import (
QuantumNoiseCollapse,
VonNeumannEntropy
)
import numpy as np
# Inicializar sistema
collapse_system = QuantumNoiseCollapse(prn_influence=0.6)
# Crear estado cuántico de prueba
state = np.array([1/np.sqrt(2), 1/np.sqrt(2)])
density_matrix = VonNeumannEntropy.density_matrix_from_state(state)
quantum_states = np.random.randn(10, 2)
# Matriz métrica (disipación)
M = np.array([[0.1, 0.0], [0.0, 0.1]])
# Simular colapso con estructura metripléctica
result = collapse_system.simulate_wave_collapse_metriplectic(
quantum_states=quantum_states,
density_matrix=density_matrix,
prn_influence=0.6,
previous_action=1,
M=M
)
# Resultados
print(f"✓ Estado colapsado: {result['collapsed_state']:.6f}")
print(f"✓ Acción bayesiana: {result['action']}")
print(f"✓ Entropía Shannon (norm): {result['shannon_entropy_normalized']:.6f}")
print(f"✓ Entropía von Neumann: {result['von_neumann_entropy']:.6f}")
print(f"✓ Coherencia: {result['coherence']:.6f}")
print(f"✓ Distancia Mahalanobis: {result['mahalanobis_normalized']:.6f}")
print(f"✓ Evolución metripléctica: {result['metriplectic_evolution']:.6f}")
print(f"✓ Posterior bayesiana: {result['bayesian_posterior']:.6f}")
```
### Ejemplo 4: Optimización de Estados Cuánticos
```python
from quoremind import QuantumNoiseCollapse
import numpy as np
# Inicializar
collapse_system = QuantumNoiseCollapse(prn_influence=0.6)
# Estados iniciales aleatorios
initial_states = np.random.randn(5, 2)
target_state = np.array([0.8, 0.2])
# Optimizar hacia estado objetivo
optimized_states, final_loss = collapse_system.optimize_quantum_state(
initial_states=initial_states,
target_state=target_state,
max_iterations=100,
learning_rate=0.01
)
print(f"✓ Pérdida final: {final_loss:.6f}")
print(f"✓ Estados optimizados:\n{optimized_states}")
```
### Ejemplo 5: Análisis de Anomalías con Mahalanobis
```python
from quoremind import QuantumBayesMahalanobis
import numpy as np
# Inicializar
analyzer = QuantumBayesMahalanobis()
# Estados de referencia (distribución normal)
reference_states = np.random.randn(100, 2)
# Estados anómalos
anomalous_states = np.random.randn(10, 2) + np.array([3.0, 3.0])
# Calcular distancias de Mahalanobis
distances = analyzer.compute_quantum_mahalanobis(
reference_states,
anomalous_states
)
print(f"Distancias Mahalanobis (anomalías):")
for i, d in enumerate(distances):
print(f" Estado {i}: {d:.4f}")
# Umbral de detección (ejemplo: 3σ)
threshold = np.mean(distances) + 3 * np.std(distances)
anomalies = distances > threshold
print(f"\n✓ Anomalías detectadas: {np.sum(anomalies)}/{len(anomalies)}")
```
---
## 📊 Métricas y Normalizaciones
### Normalización de Entropía
El framework ofrece **5 métodos** para normalizar entropía a `[0, 1]`:
| Método | Fórmula | Caso de Uso |
|--------|---------|-----------|
| **sigmoid** | `1/(1+e^-S)` | ✅ Recomendado (suave, diferenciable) |
| **tanh** | `(tanh(S/2)+1)/2` | Simétrico alrededor de 0.5 |
| **log_compression** | `log(1+S)/log(1+max_S)` | Física estadística |
| **min_max** | `S/log(dim)` | Teórico puro |
| **clamp** | `min(S/max, 1.0)` | Rápido/simple |
### Parámetros de Configuración
```python
from quoremind import BayesLogicConfig
config = BayesLogicConfig(
epsilon=1e-6,
high_entropy_threshold=0.8, # Umbral de entropía alta
high_coherence_threshold=0.6, # Umbral de coherencia alta
action_threshold=0.5 # Umbral para acción bayesiana
)
```
---
## 🔍 Validación y Testing
El framework incluye validación automática:
```python
# Validación de estructura metripléctica
# ✓ Ecuaciones de Hamilton se satisfacen
# ✓ dS/dt > 0 (producción de entropía positiva)
# ✓ Conservación de energía (parte reversible)
# Validación de convergencia (Adam)
# ✓ Loss disminuye monotónicamente
# ✓ Gradientes no explotan
# ✓ Estados convergen a objetivo
```
---
## 🧬 Ecuaciones Fundamentales
### Entropía de von Neumann
```
S(ρ) = -Tr(ρ log ρ) = -Σ λᵢ log λᵢ
```
### Corchetes de Poisson
```
{f, g} = (∂f/∂q)(∂g/∂p) - (∂f/∂p)(∂g/∂q)
```
### Ecuación de Liouville
```
df/dt = {f, H}
```
### Estructura Metripléctica
```
df/dt = {f, H} + [f, S]_M
donde:
- {f, H}: parte reversible (Hamiltoniana)
- [f, S]_M: parte disipativa (matriz métrica M)
```
### Distancia de Mahalanobis
```
D_M = √[(x - μ)ᵀ Σ⁻¹ (x - μ)]
```
### Teorema de Bayes
```
P(A|B) = P(B|A) × P(A) / P(B)
```
---
## 🎯 Casos de Uso Principales
### 1. **Detección de Anomalías Cuánticas**
```python
# Detectar intrusión mediante Mahalanobis anómala
distances = analyzer.compute_quantum_mahalanobis(
reference_states,
observed_states
)
anomaly_detected = (distances > threshold).any()
```
### 2. **Monitoreo de Decoherencia**
```python
# Rastrear decoherencia esperada vs. anómala
for cycle in range(n_cycles):
result = collapse_system.simulate_wave_collapse_metriplectic(...)
entropy = result['shannon_entropy_normalized']
mahal = result['mahalanobis_normalized']
# Si ambos son anormalmente altos → posible ataque
if entropy > 0.9 and mahal > 0.8:
log_alert("INTRUSION DETECTED")
```
### 3. **Optimización de Cifrado Dinámico**
```python
# Generar estados objetivo resistentes a ruido
target = generate_secure_state()
optimized, loss = collapse_system.optimize_quantum_state(
initial_states=random_states,
target_state=target,
max_iterations=200
)
# Los estados optimizados resisten interferencia
```
### 4. **Análisis Forense**
```python
# Estimar parámetro de no-localidad λ desde D_M anómala
lambda_estimate = estimate_nonlocality(anomalous_distances)
# Documentar en log forense
```
---
## 📈 Rendimiento y Complejidad
| Operación | Complejidad | Tiempo (aprox.) |
|-----------|------------|-----------------|
| Entropía von Neumann | O(n³) | ~0.1ms (n=2) |
| Corchete de Poisson | O(1) | ~0.05ms |
| Mahalanobis (vectorizado) | O(nm²) | ~1ms (n=100, m=2) |
| Optimización (100 iter) | O(nm²·iter) | ~500ms |
---
## 🐛 Troubleshooting
### Error: `ValueError: Argumento entropy debe estar entre 0.0 y 1.0`
**Solución**: Usar normalización automática (ya implementada)
```python
entropy_norm = 1.0 / (1.0 + np.exp(-entropy))
```
### Error: Matriz de covarianza singular
**Solución**: El código usa pseudo-inversa automáticamente
```python
inv_cov = np.linalg.pinv(cov_matrix) # Pseudo-inversa
```
### Convergencia lenta en optimización
**Solución**: Aumentar learning_rate o max_iterations
```python
optimized, loss = collapse_system.optimize_quantum_state(
initial_states=states,
target_state=target,
max_iterations=500, # ← Aumentar
learning_rate=0.05 # ← Aumentar
)
```
---
## 📚 Referencias y Documentación
- **Dinámica Metripléctica**: Morrison, P. J. (1986). "Structural, Hamiltonian, and Lagrangian Formulation"
- **Entropía von Neumann**: von Neumann, J. (1932). "Mathematical Foundations of QM"
- **Ecuación de Lindblad**: Lindblad, G. (1976). "On the Generators of QDynamical Semigroups"
- **Distancia Mahalanobis**: Mahalanobis, P. C. (1936). "On the Generalized Distance"
- **Lógica Bayesiana**: Bayes, T. (1763). "Essay Towards Solving a Problem"
---
## 🤝 Contribuciones
Las contribuciones son bienvenidas, especialmente en:
- 🔹 **Integración de Polaridad del Vacío** `η(r)` como modulador de M
- 🔹 **Rastreo Forense Avanzado**: Estimación de `λ` desde anomalías
- 🔹 **Quantum Machine Learning**: Optimización de función objetivo con QML
- 🔹 **GPU Acceleration**: Vectorización CUDA/ROCm
- 🔹 **Interfaz Gráfica**: Dashboard en tiempo real de métricas
---
## 📄 Licencia
Este proyecto está distribuido bajo la licencia **Apache 2.0**.
```
Copyright 2025 Jacobo Tlacaelel Mina Rodríguez
Licensed under the Apache License, Version 2.0
```
Ver [LICENSE](LICENSE) para detalles completos.
---
## 📞 Contacto y Soporte
- **Autor**: Jacobo Tlacaelel Mina Rodríguez
- **Email**: jakocrazykings@gmail.com
- **Issues**: [GitHub Issues](https://github.com/smokeappstore/QuoreMind-Metriplectic/issues)
- **Documentación**: [Wiki](https://github.com/smokeappstore/QuoreMind-Metriplectic/wiki)
---
## 🎓 Cita Académica
Si usas QuoreMind en investigación, por favor cita:
```bibtex
@software{quoremind2025,
title={QuoreMind v1.0.0: Sistema Metripléctico Cuántico-Bayesiano},
author={Mina Rodríguez, Jacobo Tlacaelel},
year={2025},
url={https://github.com/smokeappstore/QuoreMind-Metriplectic},
license={Apache-2.0}
}
```
---
<div align="center">
<h1> Last Updated: Noviembre 2025 </h1>
Version: 1.0.0
Status: ✅ Production Ready
</div>---
license: apache-2.0
---