How voxtech-byte/invest works
Sovereign is an IDX quantitative trading terminal with an interactive Streamlit dashboard and a separate automated scanning/execution entry point. The principal workflow fetches market data, enriches it with quantitative and institutional signals, applies portfolio and exit-risk checks, then presents results or executes trades and records/alerts them. The README documents additional risk and intelligence capabilities included here, though several are represented only by their repository paths; sampled excerpts do not establish all internal call wiring.
Main entry points: main.py Automated Runner · signals.py Signal Scoring · app.py Streamlit Dashboard · database.py Portfolio Records
Components 24
Entry Points
- Streamlit Dashboard
app.py - Automated Runner
main.py
Market Intelligence
- Market Data Fetcher
data/data_fetcher.py - Market Data APIs
- News Intelligence
integrations/news_aggregator.py - Technical Indicators
core/indicators.py
Trading and Risk
- Signal Scoring
core/signals.py - Institutional Analysis
core/institutional.py - Monte Carlo Risk
core/monte_carlo.py - Dark Pool Detection
core/dark_pool.py - Black Swan Alarm
core/black_swan.py - Sector Rotation
core/sector_rotation.py - Execution Risk Gates
core/executive.py
Portfolio and Integrations
- Broker Simulator
mock_broker.py - Portfolio Records
data/database.py - Local JSON Mirrors
- Supabase
- Google Sheets Logger
google_sheets_logger.py - Telegram Alerts
integrations/alerts.py - Telegram Queue
integrations/telegram_queue.py
Dashboard Experience
- Dashboard Components
components - Terminal Styling
ui/terminal_style.py
Other components
- Trader
- Automation Trigger
Connections 25
- Trader → Streamlit Dashboard: opens dashboard
- Automation Trigger → Automated Runner: starts scans
- Automated Runner → Market Data Fetcher: fetches prices
- Market Data Fetcher → Market Data APIs: requests data
- Automated Runner → Signal Scoring: scores symbols
- Signal Scoring → Technical Indicators: uses indicators
- Signal Scoring → Institutional Analysis: calculates footprint
- Signal Scoring → Monte Carlo Risk: runs simulations
- Automated Runner → Execution Risk Gates: checks trade gates
- Automated Runner → Broker Simulator: executes orders
- Automated Runner → Portfolio Records: saves positions
- Automated Runner → Google Sheets Logger: logs trades
- Automated Runner → Telegram Alerts: formats alerts
- Telegram Alerts → Telegram Queue: queues messages
- Portfolio Records → Local JSON Mirrors: mirrors records
- Portfolio Records → Supabase: reads and writes
- Streamlit Dashboard → Dashboard Components: renders views
- Streamlit Dashboard → Terminal Styling: styles interface
- Streamlit Dashboard → Market Data Fetcher: loads market data
- Streamlit Dashboard → Signal Scoring: shows analysis
- Streamlit Dashboard → Portfolio Records: reads portfolio
- Signal Scoring → Dark Pool Detection: uses detection
- Signal Scoring → Black Swan Alarm: uses alarm
- Signal Scoring → Sector Rotation: uses sector analysis
- News Intelligence → Market Data APIs: collects news