Megainteligencia Asíncrona "Local-First" de Grado Corporativo Mythos-Tier.
Orquestador universal de LLMs, pipelines multimedia, Agentes Autónomos, Game Servers y HITL.
Arquitectura sin dependencias masivas · Zero-Cloud · Control total en 1 PC.

Caution

Este es un ecosistema cerrado Mythos-Tier Local-First. No es open-source público. Core Operacional Privado de DarckRovert — uso strictly no comercial.

---

🌌 Filosofía y Problema que Resuelve

En el desarrollo tradicional, orquestar clústeres de IA locales (Ollama, LM Studio), motores de difusión (Fooocus), servidores C++ (MangosD/WoW) y pipelines CI/CD desde una sola máquina resulta en colisiones de hardware, puertos huérfanos, OOM en VRAM y latencias de segundos.

Gravity AI Bridge V30.0 MYTHOS elimina todos estos problemas con Python nativo puro y un frontend React/Vite de alta respuesta. Su filosofía:

Nota de Seguridad: La versión V30.0 MYTHOS ha pasado una rigurosa auditoría de código, erradicando vulnerabilidades de ReDoS y garantizando resiliencia absoluta contra fallos silenciosos en operaciones asíncronas y de Git.

• Zero Dependencias Masivas: Latencia interna en microsegundos, payload de memoria insignificante.
• Conciencia Dinámica del Host: Auto-diagnóstico de RAM y VRAM, ajuste dinámico de num_ctx de Ollama en tiempo real según estrés térmico.
• Local-First: Sin enviar datos a la nube salvo APIs cloud explícitamente configuradas.
• Mythos-Tier Control: Dashboard SPA (React) unificado con observabilidad total en tiempo real.

---

🏛 Módulos del Ecosistema V30.0 MYTHOS

📰 Reportero Autónomo (Agente Periodístico)

• Operación Continua (Daemon): Un agente persistente que despierta aleatoriamente cada 4-8 horas (news_daemon.py).
• Investigación Web Profunda: Analiza temáticas complejas de geopolítica y ciberseguridad a través de Web Search y fuentes independientes vía RSS de YouTube (ej. Los Liberales).
• Redacción y Publicación End-to-End: 7 Nodos Atómicos en workflows/reporter.json orquestan RSS → WebSearch → LLM → Normalización → news.json → VideoJob → GitDeploy. Cuenta con sanitización extrema en URLs (Pollinations Safe-Encoding) y publicación atómica.
• Auto-Mantenimiento: Sincroniza bibliotecas e imágenes eliminando duplicados mediante un sistema de slugs.

🧠 Multi-Agent Orchestrator (core/multi_agent.py)

• Dispara peticiones REST concurrentes a múltiples modelos/APIs en paralelo.
• Voting Consensuado / Paralelo / Debate: 2, 3 o 5 modelos votan la respuesta óptima o debaten un resultado mediante controles de UI nativos.
• Reasoning Stripper: Filtra tokens <think> de modelos como DeepSeek-R1 via Regex antes de mostrarlos.
• Agent Routing: Selección dinámica de modelo/proveedor según --role (auditor, planner, coder, researcher, executor).

🖥️ Dashboard V16.1 PRO React SPA (frontend/dist)

Panel de control unificado con 25 componentes orquestados en tiempo real:

Panel	Función
💬 Chat Auditor	LLM chat con streaming SSE, plantillas, soporte multi-rol y comandos nativos (/limpiar, /rag, /fabrica, /tareas, /investiga)
🏠 Mission Control	KPIs en vivo: tokens, queue, costos, modelos activos
🎨 Vision Studio	UI iframe de Fooocus integrado
🖼️ Image Queue	Cola Fooocus con SSE stream de progreso
🎬 Video Studio	Generación de videos CPU-only con narración TTS
🎨 Image Lab	Generación via Pollinations.ai con historial
🚀 Deploy	Pipeline FabricaWeb → Netlify
⚔️ Game Servers	Control MangosD WoW (start/stop/log/players/backup)
🤖 Multi-Agent	Comparación/voting multi-modelo simultáneo
🖥️ Hardware	Perfil GPU/VRAM/NPU/CPU en tiempo real
💰 Monetización	Hub de ingresos: AdSense, Afiliados CPA, Multi-idioma, Social Uploads
💸 Auto-Pilot	BountyHunter & Infiltrator: Bot 100% autónomo para conseguir clientes en Freelancer.com
💰 Cost Center	Costos por proveedor, límites diarios, breakdown
⚡ Watchdog	Engine Watchdog: lock/unlock de modelo
💾 Sessions	Sesiones persistentes + workers activos con selector de role
📚 RAG	Estado del índice RAG, activar/desactivar inyección en chat
🔌 MCP Servers	Adaptadores MCP: tools, resources, estado de conexión
🛠️ Tools	Code Runner, Web Search, Git, Grep
⚡ Tools Pro	Versión avanzada con terminal reactiva
🕷️ Firecrawl	Scraping de URLs en Markdown (Firecrawl API o fallback HTML)
🛡️ HITL Approval	Intercepción y aprobación humana de tools de alto riesgo
📡 System Status	Estado completo de backends, latencias, modelos
🔒 Security	Monitor de proceso### 🔄 Multi-Session Bridge V30.0 MYTHOS (core/session_runner.py)

• CapacityWake + SessionSpawner: hasta 32 subprocesos de agente aislados simultáneos.
• Spawn vía UI con selector de rol (auditor/planner/coder/researcher/executor).
• Kill de workers activos con estado PID en tiempo real.
• Endpoints: POST /v1/sessions/spawn, POST /v1/sessions/kill, GET /v1/sessions/active.

🛡️ HITL — Human in the Loop (core/hitl_manager.py)

• Intercepta tools de alto riesgo: code_runner, shell_exec, file_write, deploy, git_push, etc.
• Cola thread-safe con timeout de 120s y auto-rechazo.
• Aprobación/rechazo desde el Dashboard en tiempo real con badge de alerta en el sidebar.
• Bypass en modo background (permisos absolutos).

🕷️ Firecrawl Scraper (core/firecrawl_scraper.py)

• Modo premium: Firecrawl API → Markdown limpio y estructurado.
• Modo fallback: urllib nativo sin dependencias externas → texto plano desde HTML.
• Configurable via firecrawl_api_key en config.yaml.

🔌 MCP Adapter (core/mcp_adapter.py)

• Protocolo JSON-RPC stdio para servidores MCP externos.
• Auto-reconexión, list_tools, list_resources, read_resource.
• Registro global de adaptadores accesible desde el Dashboard.

🎬 Video Studio Multi-Agent & Motores Demoscene V30 PBR

Pipeline multimedia de alta fidelidad orquestado asíncronamente en daemon. Completamente reestructurado bajo el paquete /core/video/ para máxima resiliencia, con Motores Matemáticos V30 GLSL, Renderizado Dual Nativo y despliegue para redes sociales:

• Dual Render Nativo en GPU: El motor V30 (Interstellar, Turing Patterns, etc.) renderiza matemáticamente dos veces. Un Master Horizontal (1920x1080) y un Master Vertical (1080x1920) puro sin recortes FFMPEG.
• Smart Subtitle Safe-Zone: Motor .ASS Aspect-Ratio Aware. Adapta dinámicamente los márgenes laterales (MarginL 40px/440px) y anclajes verticales según el aspect ratio para jamás salirse del encuadre seguro de TikTok.
• Generador Multi-Escena V30: Flujo unificado que coordina generación de historia, split de diálogos, TTS (Edge-TTS) asíncrono y Whisper para metadatos temporales de precisión.
• Auto-Bypass de Fallas: Sistema modular. Si falla Fooocus, el generador reintenta; si el LLM colapsa, usa un script genérico con [visual anchor] estricto.
  • audio_processor.py: Análisis FFT extrae frecuencias separadas (Bass, Mid, High) para reactividad visual, además de compresión sidechain y TTS cinemático.
  • glsl_renderer_v13.py: Cuna de las 5 Joyas Matemáticas V30 (Interstellar Kerr Black Hole, Turing Patterns, Inception KIFS, Neon Fluid, Organic Core). Iluminación basada en imagen (IBL) y post-procesado Hollywood (Cyber Glitch, Aberración Cromática, Film Grain orgánico).
  • pipeline.py: Base de datos SQLite (WAL), daemon worker threads, y gestor de Auto-Routing Dual (Generación simultánea del Máster Horizontal 16:9 y el Center-Crop Vertical 9:16).
  • youtube_uploader.py: Implementación del OAuth2 Soft Shield, que detecta tempranamente tokens inválidos y frena peticiones a red sin abortar el costoso render local.

Flujo Híbrido de Renderizado Extremo:

1. Pipeline Multi-Agente (Research & Scripting): El Writer estructura la lírica y el Retention Auditor evalúa el anclaje emocional.
2. Generador de Ambientes: Descarga asíncrona de assets o Evasión Total AI al utilizar los motores de shaders puristas V30.
3. Composición 3D (GLSL PBR): Cruce reactivo de las frecuencias del audio con la geometría 3D SDF (Odisea Espacial, Tunnel Cuántico, Mandelbulb) mapeando la imagen AI como ecosfera luminosa IBL.
4. Ensamble Final: FFmpeg unifica capas visuales de alta precisión de cuadros y escupe la Copia Dual.

Reproductor Web Integrado: Stream de video nativo en el Dashboard y Auto-Distribución a redes protegida por el Shield.

📚 Course Generator & Scheduler (Info-Productos)

• Generación de Cursos (course_generator.py): Crea el syllabus completo de un curso o lista de reproducción, definiendo lecciones progresivas optimizadas para YouTube.
• Content Scheduler (content_scheduler.py): Automatiza la producción de estos cursos, encolando videos diariamente de forma autónoma sin intervención humana.

💸 Autonomous Monetization Factory & Social Repurposing

Sistema pasivo integrado en el pipeline de renderizado que multiplica los ingresos orgánicos.

• Social Assets Generator (social_assets_generator.py): Al terminar un video, extrae su guion y genera automáticamente:
  • Hilos virales para Twitter/X.
  • Carruseles para Instagram.
  • Posts profesionales para LinkedIn.
• Language Cloner: Traduce guiones (LLM) y genera audio en EN/PT/FR/DE recomponiendo videos con los assets ya renderizados.
• Affiliate Manager: Banco de 20+ programas CPA categorizados por nicho. Inyecta CTAs dinámicos en las descripciones de YouTube.
• Social Distribution: Auto-publicación simultánea a TikTok y Instagram Reels para viralizar contenido corto (Shorts de 58s).
• Revenue Tracker: Dashboard estadístico que proyecta ingresos basados en vistas, CTR y retención por categoría.

🎨 Image Queue / Fooocus (core/image_queue.py)

• Bypass nativo del WebSocket Gradio con validación real de output.
• SSE stream en /v1/queue/stream — sin polling, flujo puro de eventos.
• Diferenciación real de imágenes generadas vs. pre-existentes (0% falsos positivos).

🕹️ Game Server Manager (core/game_server_manager.py)

• Subproceso MangosD con Ring-Buffer Deque de 500 líneas en RAM.
• Pre-flight MySQL antes de arrancar (evita corrupción de Character-Files).
• Auto-backup mysqldump en cierre, historial de jugadores, exposición WAN.

🎥 OBS Studio Control & Gravity Spark V30.0 MYTHOS (core/obs_client.py & core/obs_spark_engine.py)

• Control Total de OBS: Auto-conexión vía WebSocket v5. Gestiona escenas, fuentes, mute/volumen, streaming y grabación desde la API.
• Gravity Spark (Motor de Overlays AI): Reemplaza costosos servicios de overlays web. Genera código HTML/JS autocontenido en tiempo real usando tu LLM local, inyectándolo directamente como Browser Source en OBS.
• Capacidad de modificar overlays al vuelo ("hazlo azul", "añade un borde neón") sin recargar OBS.

🧠 RAG (rag/)

• Indexación de documentos locales en _rag_index/.
• Inyección automática en /v1/chat/completions cuando rag_enabled: true.
• Toggle en caliente via POST /v1/rag/toggle.

🔐 Security Monitor (core/security_monitor.py)

• Whitelist dinámica (Discord, Chrome, BattleNet, Steam) → 98% menos spam en logs.
• GeoIP tracker de IPs externas con cache.
• Anti-DDoS local: bloqueo por IP tras 120 peticiones en ventana.
• Rotación de audit log en >5MB o >10,000 líneas.

💰 Cost Tracker + Rate Limiter

• Contabiliza tokens entrada/salida por proveedor en _cost_log.json.
• Límite diario configurable; HTTP 429 al superarlo.
• Rate limiter por IP en ventana de tiempo.

⚙️ Engine Watchdog & Turbo KV (core/engine_watchdog.py)

• Monitorea el mejor proveedor disponible.
• Lock/unlock de modelo para fijar en modo manual.
• Compatible con perfil de hardware (VRAM, CPU cores, RAM).
• Turbo KV: Detecta automáticamente si se usa Ollama y configura en tiempo de ejecución las variables de entorno OLLAMA_KV_CACHE_TYPE=q4_0 y OLLAMA_FLASH_ATTENTION=1 para comprimir la cache 4x.

---

🚀 Instalación

Requisitos

• Windows 10 1809+ (64-bit) o Windows 11
• Python 3.10+ en PATH
• Ollama, LM Studio, o cualquier backend OpenAI-compatible

Instalación desde Fuente

git clone https://github.com/DarckRovert/Gravity_AI_bridge.git
cd Gravity_AI_bridge
pip install -r requirements.txt
cd frontend && npm install && npm run build && cd ..
python bridge_server.py

Dashboard disponible en: http://localhost:7860

Instalación con Installer (Windows)

Descargar Gravity_AI_Bridge_V30.0_Setup.exe desde Releases y ejecutar como administrador.

---

⚙️ Configuración Inicial y Seguridad de APIs

Para garantizar la máxima seguridad del ecosistema, todos los datos sensibles y API keys locales han sido completamente purgados del repositorio público (config.yaml y claves encriptadas se excluyen automáticamente a través de .gitignore).

🚀 Inicialización Automática (Zero-Configuration)

Al iniciar el Bridge por primera vez (python bridge_server.py), el núcleo detecta automáticamente la ausencia de config.yaml y crea una copia limpia a partir de config.yaml.example sin credenciales reales. ¡Listo para arrancar al instante!

🖥️ Configuración Interactiva desde el Dashboard

No necesitas editar archivos de texto manualmente. Una vez iniciado el servidor, accede al Dashboard en http://localhost:7860 y dirígete al panel System Settings (icono de engranaje):

1. Gestión de API Keys: Introduce tus llaves de OpenAI, Anthropic, Groq, Nvidia, u OpenRouter de forma visual.
2. Cifrado Local Seguro: Las llaves introducidas en la UI se cifran automáticamente en tu máquina física utilizando Windows DPAPI y se almacenan localmente de forma inmutable en tu almacén personal (_keystore.bin). Nadie más tendrá acceso a ellas.
3. Proveedor Universal AI: Puedes configurar cualquier endpoint compatible con OpenAI (Base URL + Model Name + API Key) de manera extremadamente sencilla.
4. Límites de Costos: Ajusta el presupuesto diario en dólares desde la barra deslizadora directamente en la UI.

---

🔐 Seguridad

Ver SECURITY.md para política de vulnerabilidades y reporte responsable.

---

📖 Documentación

Documento	Contenido
Wiki Principal	Índice general
Arquitectura	Diagrama de módulos y flujos
Guía API	Todos los endpoints REST
Troubleshooting	Guía de soluciones y FAQ
Evolución Agéntica	Roadmap del sistema
CHANGELOG	Historial de versiones
CONTRIBUTING	Cómo contribuir

---

Note

Ecosistema local privado V30.0 MYTHOS Edition. 📖 WIKI CORPORATIVA | 📜 CONTRIBUCIÓN | 🔒 SEGURIDAD

_{© 2026 DarckRovert · Gravity AI Bridge V30.0 MYTHOS Edition — Motor Cinematic PBR. All architectural assets belong to their proprietary author.}