🔮 The Contrarian Oracle
An Autonomous Multi-Agent OSINT System for Financial Narrative Deconstruction
What Is This?
The Contrarian Oracle uses 4 collaborative AI agents (built with CrewAI) to perform a "Red Team" analysis on any stock ticker. It identifies the dominant market narrative, actively searches for contradicting evidence, and produces a Divergence Score (0-100) that quantifies how much hidden risk the mainstream narrative is ignoring.
⚠️ This is NOT a price prediction tool. It is an information arbitrage system.
Architecture
┌─────────────────────────────────────────────────────────┐
│ STREAMLIT UI (app.py) │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌────────┐ │
│ │ Sidebar │ │ Charts │ │ Agent │ │ Report │ │
│ │ Controls │ │ (Plotly) │ │ Stream │ │ View │ │
│ └──────────┘ └──────────┘ └──────────┘ └────────┘ │
└─────────────────────┬───────────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────────┐
│ CREW ORCHESTRATION │
│ (src/crew/oracle_crew.py) │
│ │
│ ┌──────────────┐ ┌──────────────┐ │
│ │ Agent 1: │ │ Agent 2: │ (Independent) │
│ │ Trend │ │ Sentiment │ │
│ │ Scraper │ │ Synthesizer │ │
│ └──────┬───────┘ └──────┬───────┘ │
│ │ │ │
│ └────────┬────────┘ │
│ ▼ │
│ ┌──────────────┐ │
│ │ Agent 3: │ (Receives 1 + 2) │
│ │ Contrarian │ │
│ │ Skeptic │ │
│ └──────┬───────┘ │
│ ▼ │
│ ┌──────────────┐ │
│ │ Agent 4: │ (Receives 1 + 2 + 3) │
│ │ Final │ │
│ │ Arbitrator │ │
│ └──────────────┘ │
└──────────────────────────────────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────────┐
│ TOOLS LAYER │
│ ┌──────────┐ ┌───────────┐ ┌──────────┐ ┌────────┐ │
│ │ yfinance │ │ DuckDuck │ │ SEC │ │ FRED │ │
│ │ Tool │ │ Go News │ │ EDGAR │ │ Macro │ │
│ └──────────┘ └───────────┘ └──────────┘ └────────┘ │
│ ┌──────────────────────────────────────────────────┐ │
│ │ RAG (ChromaDB + Sentence-Transformers)│ │
│ └──────────────────────────────────────────────────┘ │
└──────────────────────────────────────────────────────────┘
│
┌─────────────────────▼───────────────────────────────────┐
│ SCORING ENGINE │
│ (src/scoring/divergence_calculator.py) │
│ │
│ Score = 0.25×Technical + 0.20×Sentiment │
│ + 0.25×Insider + 0.15×Fundamental │
│ + 0.15×Macro │
│ │
│ 0-20: Consensus Aligned │ 61-80: High Alert │
│ 21-40: Minor Cracks │ 81-100: Extreme Divergence │
│ 41-60: Significant Div. │ │
└──────────────────────────────────────────────────────────┘
| 
| 
|