🦅 FEAT NEXUS PRIME

<div align="center">

The first institutional-grade Algorithmic Trading Platform that bridges MetaTrader 5 with an Autonomous AI Córtex (Dockerized Brain + SSE + RAG).

Mission • Command Center • Architecture • Omni-Audit • Institutional DB

</div>

🎯 The Mission

NEXUS PRIME is not just an indicator or a bot; it is a Mission-Critical Ecosystem designed for high-frequency data extraction, ML-driven analysis, and autonomous decision-making using the FEAT (Form, Space, Acceleration, Time) methodology.

🎮 Command Center (One-Switch Control)

The entire system lifecycle is controlled via a unified Python Orchestrator:

• `nexus.bat`: Initializes the "Golden Start".

1. Bootstraps MetaTrader 5.
2. Orchestrates Docker Compose (Brain + Dashboard).
3. Executes Internal Sync Audit.
4. Runs the War Room Report.
5. Opens the Visual Interface.

• `stop_nexus.bat`: Executes a Graceful Shutdown.

1. Safe Docker teardown (Persistence guaranteed).
2. Professional MT5 process termination.

• `check_system.bat`: The Omni-Auditor on demand.

🏗️ Architecture: NEXUS PRIME

The system operates on a decentralized core-peripheral model:

1. THE BRIDGE (MQL5): Native indicators (UnifiedModel_Main.mq5, InstitutionalPVP.mq5) extraction engine with high-performance ZMQ streaming.
2. THE BRAIN (Docker/Python): A specialized MCP Server hosting the ML Engine, Data Collectors, and the RAG Memory (ChromaDB).
3. THE PERSISTENCE (Supabase): Institutional-grade schema for high-frequency tick logging, signal auditing, and model performance tracking.
4. THE VISION (Dashboard): Next.js + Framer Motion visual cockpit for real-time monitoring.

🕵️ Omni-Audit (Self-Healing)

Every component is monitored by the NEXUS Omni-Auditor. If a data blocker is detected (MT5 Offline, ZMQ Latency > 50ms, DB Sync Failed), the system generates a machine-readable REPAIR_REQUEST to trigger autonomous self-healing by the Antigravity Agent.

📊 Institutional Persistence

The database schema (institutional_schema.sql) is designed for senior quantitative analysis:

• `market_ticks`: Nanosecond-aware price capture.
• `feat_signals`: Comprehensive audit trail with confidence scores and top-drivers.
• `ml_inference_logs`: Feature snapshots at the moment of prediction for retrospective learning.
• `knowledge_base`: RAG persistence for the autonomous agent.

⚡ Quick Start (The NEXUS Protocol)

1. Requirements

• Windows 11 (for MT5 Terminal).
• Docker Desktop.
• Python 3.12+.

2. Configuration

Fill your .env with the Supabase credentials and MT5 paths:

SUPABASE_URL=https://your-project.supabase.co
SUPABASE_KEY=your-service-role-key
MT5_PATH=C:\Program Files\LiteFinance MT5 Terminal\terminal64.exe

3. Ignition

Run the main orchestrator:

.\nexus.bat

📜 Repository Hygiene

This project follows strictly the Saneamiento Protocol:

• No binary files in Git.
• No local logs in Git.
• No environment variables in Git.
• Clean development/production branch harmonization.

<div align="center">

Built for the Next Generation of Quantitative Trading. Powered by SrAndres629 & Antigravity Agent.

</div>