🌌 Trinity Library: Fractal & Golden-Ratio-Based Reasoning Engine

Bilingual README | README bilingüe (English & Español)

🇬🇧 Introduction (English)

Trinity is a Python library that implements the core reasoning engine of the Aurora Model, designed around fractal processing principles and the golden ratio (φ ≈ 1.618). Trinity is not an application—it is the foundation of intelligent computation.

🔍 Key Features

• Trigate: Atomic unit for reasoning, learning, and deduction
• Transcender: Synthesizes high-level meaning via golden-ratio-based thresholds
• Evolver: Manages dynamic, Fibonacci-based context across layers
• GoldenExtender: Enables deep interpretability through recursive reconstruction
• FractalModel: Full layered system with both synthesis and analysis

🧩 System Estructure / Estructura del Sistema

inputs → Trigates → Transcender → Evolver → output
                         ↓
                      Extender
                         ↓
                   Interpretación

---

🧪 Example

from trinity import FractalModel

model = FractalModel(num_layers=3)
inputs = [0b001, 0b010, 0b100]
model.train([ (inputs, 0b110) ], epochs=3)
output = model.process(inputs, 2)
model.golden_insight(output, 2)

🇪🇸 Introducción (Español)

Trinity es una librería Python que implementa el motor de razonamiento del Modelo Aurora, basado en principios fractales y la proporción áurea (φ ≈ 1.618). Trinity no es una app, es la base lógica de la inteligencia.

🔍 Características Principales

• Trigate: Unidad mínima para razonar, aprender y deducir
• Transcender: Sintetiza conocimiento con umbral áureo (2/3)
• Evolver: Contexto dinámico con secuencias Fibonacci mod 8
• GoldenExtender: Interpretabilidad profunda y fractal
• FractalModel: Sistema completo de capas con síntesis e interpretación

🧪 Ejemplo

from trinity import FractalModel

modelo = FractalModel(num_layers=3)
entrada = [0b001, 0b010, 0b100]
modelo.train([ (entrada, 0b110) ], epochs=3)
salida = modelo.process(entrada, 2)
modelo.golden_insight(salida, 2)

---

🚀 Use Cases / Casos de Uso

• 🧠 AI interpretability / Interpretabilidad en IA
• 🤖 Conscious robotics / Robótica consciente
• 🧬 Transparent diagnosis / Diagnóstico médico explicable
• 🗣️ NLP & semantic reasoning / PLN y razonamiento semántico

---

📜 License / Licencia

Released under GPLv3.
Publicado bajo GPLv3.

“True intelligence does not only solve problems—it understands and explains its solutions.”
"La verdadera inteligencia no solo resuelve problemas, sino que comprende y explica sus soluciones." – Aurora Principle